Getting Started
Quick Start Guide
Set up a Theseus node and deploy your first agent.
Prerequisites
Rust 1.70+Go 1.21+ (optional)Docker (optional)16GB+ RAM (recommended)
Installation
1
Clone the Repository
terminal
git clone https://github.com/Theseuschain/theseuschain.git cd theseuschain
2
Install Tooling and Build
terminal
# Install development dependencies make install-dev # Build the project make build
3
Run a Local Node
terminal
# 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.
terminal
# Deploy from the repository 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.
Ecosystem Examples
For production-style SHIP implementations, see proof-of-lobster and the-prediction-market.
| 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.
flow
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
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 # Component-specific targets make test-aivm make test-consensus make test-store make test-tensor make test-ship
Next Steps
Need help? Visit GitHub (private repository; access required) and review docs/getting-started.md for upstream command references, or read the whitepaper.