# Documentation

Run your first SoyaOS Agent with hosted Cloud or local Solo, then explore the architecture, SoyaPack, API, and CLI.

- [Capabilities & sandbox](https://soyaos.ai/en/docs/capabilities-sandbox.md) — How Comet enforces what an Agent can and cannot do.
- [Solo local quickstart](https://soyaos.ai/en/docs/quickstart.md) — Download the current SoyaOS preview and run the built-in echo Agent.
- [SoyaPack v0 manifest](https://soyaos.ai/en/docs/soyapack-v0.md) — Reference for the soyapack.yaml v0 manifest — fields, capabilities, examples, common pitfalls.
- [Writing an Agent from scratch](https://soyaos.ai/en/docs/writing-an-agent.md) — Build a multi-stage Agent that fetches a URL, extracts bullets, and emits a typed artifact.
- [Research WeChat article Skills and deliver an HTML report](https://soyaos.ai/en/docs/cloud-recipes/wechat-skill-research.md) — Use SoyaOS Cloud, live GitHub search, and deterministic quality gates to create a traceable single-file Skill comparison report.
- [Cloud quickstart](https://soyaos.ai/en/docs/cloud-quickstart.md) — Sign in to SoyaOS Cloud, create an API key, and run your first hosted Agent scenario in five minutes.
- [CLI v0 reference](https://soyaos.ai/en/docs/cli-v0.md) — Every verb the soyaos binary exposes in v0, with example output.
- [Self-host a Moon on a VPS](https://soyaos.ai/en/docs/self-host-moon.md) — Stand up a cluster-edition Moon for your team — registry, auth, Comets.
- [Virtual models & BYOK](https://soyaos.ai/en/docs/virtual-models.md) — How soya:* model IDs resolve and how to bring your own LLM keys.
- [Build a dependency upgrade decision from official sources](https://soyaos.ai/en/docs/cloud-recipes/dependency-upgrade-advisor.md) — Check GitHub Releases, a CHANGELOG, and official docs live, then use SoyaOS Cloud to produce a traceable single-file HTML report.
- [Architecture](https://soyaos.ai/en/docs/architecture.md) — Planet, Moon, and Comet — the three node roles that compose every SoyaOS deployment.
- [Scope events & observability](https://soyaos.ai/en/docs/scope-events.md) — The event stream every SoyaOS run emits, and how to consume it.
- [Sign and publish a SoyaPack](https://soyaos.ai/en/docs/sign-and-publish.md) — From a working pack on your laptop to a signed, audited, prod-ready version on a Moon.
- [HTTP API](https://soyaos.ai/en/docs/http-api.md) — The wire format SoyaOS speaks — OpenAI-compatible chat completions plus the Scope event channel.
- [Generate three release-note locales from structured facts](https://soyaos.ai/en/docs/cloud-recipes/multilingual-release-notes.md) — Produce zh, zh-hant, and en release notes from one closed fact source, with invariant checks and SHA-256 integrity.
- [Editions](https://soyaos.ai/en/docs/editions.md) — Six deployment shapes from one binary — Solo to Enterprise Private.

---

Canonical HTML: https://soyaos.ai/en/docs