Overview
This documentation covers SAgents v2, Desktop v2, and Server v2, on Python 3.12+.
| Your goal | Start here |
|---|---|
| Run Sage locally | Desktop v2 |
| Use the multi-user web app | Server v2 |
| Run an agent from Python | Quick start |
| Compose plugins and Agent packages | Configuration · Extensions |
| Integrate a client | Python API · HTTP API |
Understand the runtime
Core concepts → Architecture → Memory → Tools and MCP.
Operate and contribute
Environment variables · Troubleshooting · Development.
Desktop is a local single-user host. Server is multi-user but currently runs with one worker. Persistence alone does not enable distributed execution.
Documentation scope
Legacy application guides, proposals, and historical audits are excluded from this site’s navigation and search. They remain in the repository archive for historical reference, not as v2 instructions. The separate app/wiki content describes the older product and is not the v2 reference.