Docs
Documentation
Run your first SoyaOS Agent with hosted Cloud or local Solo, then explore the architecture, SoyaPack, API, and CLI.
Getting started
Solo local quickstart
Download the current SoyaOS preview and run the built-in echo Agent.
Cloud quickstart
Sign in to SoyaOS Cloud, create an API key, and run your first hosted Agent scenario in five minutes.
Architecture
Planet, Moon, and Comet — the three node roles that compose every SoyaOS deployment.
Editions
Six deployment shapes from one binary — Solo to Enterprise Private.
Cloud recipes
Research WeChat article Skills and deliver an HTML report
Use SoyaOS Cloud, live GitHub search, and deterministic quality gates to create a traceable single-file Skill comparison report.
Build a dependency upgrade decision from official sources
Check GitHub Releases, a CHANGELOG, and official docs live, then use SoyaOS Cloud to produce a traceable single-file HTML report.
Generate three release-note locales from structured facts
Produce zh, zh-hant, and en release notes from one closed fact source, with invariant checks and SHA-256 integrity.
Concepts
Guides
Writing an Agent from scratch
Build a multi-stage Agent that fetches a URL, extracts bullets, and emits a typed artifact.
Self-host a Moon on a VPS
Stand up a cluster-edition Moon for your team — registry, auth, Comets.
Sign and publish a SoyaPack
From a working pack on your laptop to a signed, audited, prod-ready version on a Moon.
Reference
SoyaPack v0 manifest
Reference for the soyapack.yaml v0 manifest — fields, capabilities, examples, common pitfalls.
CLI v0 reference
Every verb the soyaos binary exposes in v0, with example output.
HTTP API
The wire format SoyaOS speaks — OpenAI-compatible chat completions plus the Scope event channel.