Quick Start Guide
Set up a Theseus node and deploy your first agent.
Preview access required
The repository is currently private. The instructions below assume you have the CLI binary and a testnet endpoint. If you do not yet, request access first.
Request preview accessPrerequisites
Installation
Clone the Repository (preview-access devs)
# The repository URL is provided with preview access. # Replace <preview-clone-url> with the value from your invite. git clone <preview-clone-url> theseus cd theseus
Install Tooling and Build
# Install development dependencies make install-dev # Build the project make build
Run a Local Node
# Start via Makefile make node # Equivalent cargo command cargo run --bin theseus-node
Your node will start syncing with the network. First sync may take time depending on network conditions.
Deploy Your First Agent
Once your node is running, deploy a test agent using the Theseus CLI with a SHIP file.
# Deploy from the repository example cargo run --bin theseus-cli deploy-agent examples/basic-agent.ship
Agent Registration Fields
Ecosystem Examples
| Field | Description |
|---|---|
| Code hash | Binary verification |
| Autonomy flag | 0=human-owned, 1=sovereign |
| Controller key | Optional override key |
| AIVM version | Required features |
| Resource quota | Max FLOPs per epoch |
| Stake | $THE locked for security |
Model Registration (API-Level)
Model registration currently appears in the codebase as runtime API flows (AIVM + store), not as a stable, documented one-line CLI command.
Model weights + metadata
↓
Store in TheseusStore
↓
Reference model root from agent/AIVM execution| Field | Example |
|---|---|
| Name/version | Llama 3.1 8B |
| Architecture | LLM, diffusion, etc. |
| Tensor Commit | Weight fingerprint for verification |
| Root reference | Used by agents during inference calls |
Development Workflow
Running Tests
# Run full test suite make test # Component-specific targets make test-aivm make test-consensus make test-store make test-tensor make test-ship
Next Steps
Need help? Email hello@theseus.network, or read the whitepaper. Once you have preview access, the invite includes upstream command references and the docs/getting-started.md file.