Skip to content
Docs

Quickstart

The fastest path to a running StratosAgent — your own AI accounts, local-first.

On this page

This is the shortest path from nothing to the publicly-auditable StratosAgent operating core running on your own machine. One command installs the CLI; the operating-core commands are deterministic and make no network calls.

Note
The installer is user-space and fail-closed: no sudo, nothing auto-started. It installs the pinned @efficientlabs/stratos package after checking for Node 20.19+.

1 · Install the CLI

# install the StratosAgent CLI — user-space, no sudo
curl -fsSL https://efficientlabs.ai/install.sh | sh

2 · First run — a real local completion

bash
stratos init                              # persistent node identity + a workspace
stratos task create local/demo/flow/t1    # scaffold a task
stratos complete local/demo/flow/t1 "what is sovereign AI?"   # REAL local completion
stratos eval local/demo/flow/t1           # re-verify the run's signed receipt
Note
complete needs a local OpenAI-compatible endpoint — e.g. Ollama (ollama serve + ollama pull gemma2:2b) — pointed at via --gateway or STRATOS_GATEWAY_URL (e.g. http://127.0.0.1:11434/v1/chat/completions). No model is bundled; your data stays on your machine.

complete routes local-default ($0), writes a trace, and seals it in a PQC-signed capability-receipt verifiable with the public key alone. The deterministic, no-network commands — workspace / task / capture / trace / eval / route / receipt — need no endpoint at all.

Where to next

  • Requirements — confirm your Node version and OS.
  • Configure (Vault + your own AI accounts) — seal secrets and set the cost gate.
  • Verify your install — what a healthy node looks like.
Was this page helpful?
Last updated June 3, 2026