Choose Your Path
Use this page when you know what you want to build but do not know which Aether Forge guide to follow.
Start Here
| Goal | Start with | Why |
|---|---|---|
| Try the framework safely | First 10 Minutes | No API key, no wallet, no live funds |
| Install the right package set | Install Matrix | Pick only the extras your agent actually needs |
| Understand generated files | Generated Agent Anatomy | Know which files are specs, code, config, and state |
| Build a normal non-crypto agent | Getting Started | Validated artifact loop and one sandbox tick |
| Add an LLM planner | Getting Started - Add an LLM Planner | Explicit provider setup and planner provenance |
| Build a crypto agent | End-to-End Tutorial | Sandbox first, paper mode before live capital |
| Write a strategy file | Writing Strategies | Plain-English strategy shape and generated parameters |
| Embed agents in a SaaS app | Multi-Tenant Integration | Per-tenant paths, memory, policy, and observability |
| Run multiple agents together | Multi-Agent Teams | A2A ports, cards, tasks, and team topology |
| Accept x402 payments | Accept Payments | Payment gates, budgets, and verification |
| Extend the framework | Extending the Framework | Plugin entry points and public Protocols |
| Prepare for production | Production Readiness | Doctor, rollout evidence, incidents, memory, and secrets |
Recommended Sequence
For most developers:
- First 10 Minutes
- Generated Agent Anatomy
- Getting Started
- CLI Reference
- One feature guide for your use case
For production or live-capital work:
Which Runtime Mode Should I Use?
| Situation | Command shape |
|---|---|
| General local test | forge run ./agent --environment sandbox --auto-approve |
| Crypto scaffold, no live orders | forge run ./agent --environment sandbox --mode paper --auto-approve |
| Production profile, no crypto | forge run ./agent --environment production |
| Production crypto, live capital | forge run ./agent --environment production --mode live |
--environment controls policy and promotion context. --mode controls the crypto scaffold trading backend.
What to Read Later
Skip these until the need appears:
- Open Agent Economy if you are using ERC-8004, ERC-8126, x402, or A2A trust flows.
- Skills & Registries if you are adding
SKILL.mdpackages. - Stable API if you are writing integration code against
aether_forge. - Upgrading when moving existing generated agents to a newer framework version.
Last updated on