Docs

Documentation

Everything you need to ship your first Agent with SoyaOS. Five reference pages cover install, the three node roles, the SoyaPack manifest, and the v0 CLI.

Start with Quickstart

Getting started

Quickstart

Five minutes from zero to a running soya:echo Agent.

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.

Concepts

Capabilities & sandbox

How Comet enforces what an Agent can and cannot do.

Virtual models & BYOK

How soya:* model IDs resolve and how to bring your own LLM keys.

Scope events & observability

The event stream every SoyaOS run emits, and how to consume it.

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.