astrid-runtime/bookPublic

The canonical reference for Astrid: kernel, capsules, host ABI, IPC, and the security model.

AI summary: Official documentation and guide for building with the Astrid runtime ecosystem.

Stars: 7.5K
Forks: 32
Watchers: 2
Open issues: 0
Open PRs: 1
Contributors: ~2
Commits: 18
Branches: 2

PerlApache-2.0Created Jun 6, 2026Last push 17d ago

Star history

since Jun 14, 2026

7.5K stars as of Jul 29, 2026, tracked back to Jun 14, 2026. Historical curve reconstructed from public GitHub event archives, calibrated to the current total.

Contribution activity

commits per day, last 52 weeks

17 commits in the last yearLessMore

Signals and awards

derived from tracked data

Breakout launch
7,503 stars in 63 days
Permissive license
Apache-2.0
Continuous integration
Automated checks passing

What book does

This repository houses the official documentation, tutorials, and deep architectural explanations for the Astrid runtime. It covers everything from writing your first WebAssembly capsule to understanding the intricacies of the wasip2 Component Model integration. The guide provides essential context on how to effectively use the SDKs, interact with the host ABI, and deploy robust, language-agnostic components securely.

Developers, systems engineers, and technical architects who are building applications using the Astrid WebAssembly runtime.

Comprehensive guides: Step-by-step tutorials from basic setup to advanced capsule architecture.
Architectural deep dives: Detailed explanations of the host ABI and Component Model mechanics.
Language-agnostic focus: Covers usage patterns for both the Rust and JavaScript/TypeScript SDKs.
Security practices: Documents how to properly manage identities, approvals, and capabilities.
Living documentation: Frequently updated to reflect the latest changes in the Astrid runtime.

Where teams use it

Onboarding Developers

Serve as the primary starting point for engineers learning the Astrid ecosystem.

API Reference

Quickly look up specific behaviors of Astrid's core modules like ipc and kv.

Architectural Planning

Understand how to structure complex, multi-module applications within the runtime.

Troubleshooting

Diagnose common deployment and compilation errors when building capsules.

Getting started: git clone https://github.com/unicity-astrid/book.git

README

main branch

The Unicity Astrid OS Book

The canonical reference for Unicity Astrid OS: the kernel, the capsule model, the host ABI, the bus, and the security model.

Built with mdBook.

mdbook serve --open

The reference appendices (capability catalog, host ABI error codes, topic registry) are generated from the Astrid source by tools/gen-appendices.sh. The cross-chapter "See also" footers are generated by tools/gen-see-also.pl. Both read the polyrepo source tree, so run them from a checkout that has core/, wit/, and capsules/ as siblings.

Dual-licensed under MIT and Apache 2.0.

View on GitHub

Recent activity

commits and pull requests

docs(afterword): the four-chapter afterword — The Labyrinth, The Lineage, The Harvest, The NamesakeMerged
#7 by joshuajbouw · updated 17d ago
docs(afterword): add The Harvest — the six dreams, their deaths by missing precondition, and the cannibalisation that kept the organs alive
joshuajbouw committed 90dbc34 · 17d ago
Try to fix GH pages deploymentOpen
#6 by ahtotruu · updated 17d ago
Restore GitHub Pages deploy after repository moveMerged
#5 by Copilot · updated 21d ago
Restore GitHub Pages deploy after repository move (#5)
Copilot committed 033dcf1 · 21d ago
[fix] Fix pequeñoClosed
#2 by Edgardo-Ramirez-Canales · updated 28d ago
[docs] DocsClosed
#1 by Edgardo-Ramirez-Canales · updated 28d ago
docs: promote Unicity Astrid OS bookMerged
#3 by joshuajbouw · updated 28d ago
docs: promote Unicity Astrid OS book (#3)
joshuajbouw committed 316802c · 28d ago
docs: fold in the 0.9.4 workspace CoW and contracts-skew changes
joshuajbouw committed 39acd45 · 28d ago
docs(afterword): sharpen The Namesake — the OS's world is itself, not a knowledge graph
joshuajbouw committed e7df5cc · 1mo ago
merge: fold docs/first-capsule into the site-serving branch
joshuajbouw committed 016a937 · 1mo ago

Code frequency

additions and deletions

+11K lines added, -170 removed over the last year.

Commits per week

last 52 weeks

17 commits in the last 52 weeks.

When work happens

weekday and hour

Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Date	List	Rank	Stars gained
Jun 23, 2026	daily	#1	+35
Jun 19, 2026	daily	#13	+14