unicity-astrid/book

The Astrid Book is the official documentation hub for Astrid OS, an operating system project from Unicity Labs. Think of it as the instruction manual and technical encyclopedia that explains how every piece of the operating system fits together, from its core foundation to its security rules. The documentation covers several key concepts. The "kernel" is the heart of the operating system, managing how software and hardware interact. "Capsules" appear to be a modular way of packaging functionality, similar to apps or plugins. The "host ABI" defines how different software components communicate with each other, while "the bus" likely handles internal messaging. The security model rounds out the picture, explaining how the system protects itself and its users from threats or unauthorized access. This reference is built using a tool called mdBook, which is a popular way to create searchable, web-based documentation from plain text files. The project includes some automation: scripts generate appendix tables and cross-references by scanning the actual Astrid OS source code. This means the documentation stays synchronized with the codebase rather than requiring manual updates, though generating these sections requires access to the full Astrid source tree. The primary audience is developers and engineers who want to build software for or contribute to the Astrid OS platform. If you are creating a capsule, integrating a new component, or trying to understand the system's security boundaries, this is where you would start. It serves as the single source of truth that keeps everyone aligned on how the operating system is designed to work. The project is dual-licensed under MIT and Apache 2.0, which is a common combination in open-source software that gives developers flexibility in how they use and build upon the work. The automation tooling is written partly in Perl, an older but capable scripting language well-suited to text processing tasks like generating documentation.