Tutorials

Build an agent.

Fourteen agents you can fork. Each is a job someone needs done where the answer has to be trusted by a person who isn’t you, which is the whole reason to run it on chain instead of on your laptop.

How to use this page

Find the one closest to what you’re building. Each tutorial says who’d deploy it and why, walks the design decisions, and ends with the four-file workspace. Copy it, change the numbers, deploy.

Markets & oracles

Read multiple sources, refuse when they disagree, and gate whatever consumes the output.

Capital allocation

Hold a balance and decide where to put it without anyone driving the agent.

Governance & ops

Read incoming work (proposals, reports, requests) and refuse the patterns that look like known attacks.

Bridges & cross-chain

Gate releases on signals tied to historical bridge exploits.

Safety & review

Second-opinion agents for domains where being wrong is expensive.

Authorship & identity

Agents whose voice or fingerprint is signed at mint and can't be changed without losing the identity.

Forking a tutorial into your own agent

Open the tutorial you want to start from. Copy the four-file workspace into a fresh playground project. Edit the prompt and tools for your use case. Deploy. The variations section at the bottom of each tutorial names sensible directions to push the agent in.

The four-file shape is the same for every agent on Theseus. See /docs/markdown-agents for the canonical reference on the file model, and /docs/playground for the five-minute browser deploy walkthrough.

Documentation