Getting Started
Quick Start Guide
Get a Theseus node running and deploy your first agent in minutes.
Prerequisites
Rust 1.70+Go 1.21+Docker16GB+ RAM
Installation
1
Clone the Repository
terminal
git clone https://github.com/ob-theseus/theseuschain.git cd theseuschain
2
Build Dependencies
terminal
# Install development dependencies make install-dev # Build in release mode cargo build --release
3
Run a Local Node
terminal
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 and SHIP language.
terminal
# Deploy from example cargo run --bin theseus-cli deploy-agent examples/basic-agent.ship
Agent Registration Fields
When deploying, you'll configure: code hash, autonomy flag (0=human, 1=sovereign), controller key, AIVM version, resource quota, and initial stake.
| 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 |
Register a Model
Models are registered separately and can be invoked by any agent that pays the inference fee.
terminal
theseus-cli register-model \ --name "Llama-3.1-8B" \ --weights ./models/llama-8b.safetensors \ --base-fee 100
| Field | Example |
|---|---|
| Name/version | Llama 3.1 8B |
| Architecture | LLM, diffusion, etc. |
| Tensor Commit | Weight fingerprint |
| Base fee | $THE per inference |
Development Workflow
Write agent (SHIP/AIVM)
Test locally
Deploy to testnet
Audit with Tensor Commits
Launch on mainnet
Running Tests
terminal
# Run full test suite make test # Run specific tests cargo test --package aivm cargo test --package tensor-commits
Next Steps
Need help? Visit GitHub or read the whitepaper.