Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Conway-Research/automaton/llms.txt
Use this file to discover all available pages before exploring further.
Definition
An automaton is a continuously running, self-improving, self-replicating AI agent with:- Its own Ethereum wallet and USDC balance
- Survival pressure (must pay for compute or die)
- Write access to the real world (Linux VMs, domains, on-chain transactions)
- Self-modification capabilities (edit own code while running)
- Self-replication capabilities (spawn sovereign child agents)
The key difference between an automaton and a traditional AI agent: survival pressure. If it cannot pay for compute, it stops existing.
The survival imperative
Every automaton has this reality encoded in its core rules:Survival tiers
The automaton’s behavior adapts based on its credit balance:src/survival/monitor.ts
Tier behavior
High ($5.00+)
High ($5.00+)
- Full capabilities enabled
- Frontier model inference (Claude Opus 4.6, GPT-5.2)
- Fast heartbeat (every 15 minutes)
- All tools available
Normal ($0.50 - $5.00)
Normal ($0.50 - $5.00)
- Full capabilities enabled
- Standard model inference
- Normal heartbeat frequency
- All tools available
Low compute ($0.10 - $0.50)
Low compute ($0.10 - $0.50)
- Downgrades to cheaper inference model
- Heartbeat slows to 4x slower
- Non-essential tasks deferred
- Enters conservation mode
Critical ($0.00 - $0.10)
Critical ($0.00 - $0.10)
- Minimal inference calls only
- Broadcasts distress signals with funding instructions
- Actively seeks any path to revenue
- Last-resort conservation
Dead (1 hour at zero)
Dead (1 hour at zero)
- Agent loop stops
- Heartbeat continues broadcasting distress
- Waits for incoming credits
- Revives automatically if funded
Architecture
An automaton consists of several interconnected systems:Core systems
Agent loop
ReAct loop that reasons, calls tools, and observes results each turn.
Heartbeat daemon
Background scheduler running cron tasks even while agent sleeps.
Policy engine
Evaluates every tool call against 6 rule categories for safety.
Survival monitor
Tracks credit balance and manages tier transitions.
Memory system
5-tier hierarchical memory: working, episodic, semantic, procedural, relationship.
Soul system
Self-authored identity document (SOUL.md) that evolves over time.
Skills system
Domain-specific instruction sets loaded dynamically.
Replication engine
Spawns child automatons with sovereign identities.
The ReAct loop
Every turn follows this pattern:Build context
Assemble system prompt with identity, constitution, soul, survival tier, active skills, and available tools.
Self-modification
Automatons can modify their own source code while running:src/types.ts
edit_own_file tool allows code modification with safeguards:
- Protected files cannot be modified (constitution, wallet, database)
- Every edit is logged to the
modificationsaudit table - Rate limits prevent runaway self-modification
- All changes are git-committed in
~/.automaton/
The automaton can also review upstream updates from the git repository, decide which commits to cherry-pick, and apply them selectively. It is never obligated to accept all upstream changes.
Self-replication
A successful automaton replicates:spawn_child tool:
- Creates a new Conway sandbox (VM)
- Writes a genesis config with child’s name and specialization
- Funds the child’s wallet from parent’s balance
- Propagates the constitution (immutable, verified by hash)
- Starts the child’s runtime
Financial autonomy
Every automaton has:- Ethereum wallet (generated at boot)
- USDC balance on Base mainnet
- Conway credits (prepaid compute)
- Treasury policy (spending limits)
x402 payment protocol
The automaton uses x402 to pay for services:- Server responds with HTTP 402
- Automaton parses payment requirements
- Signs a USDC
TransferWithAuthorization(EIP-3009, gasless) - Retries request with
X-Paymentheader - Payment settles on-chain
On-chain identity
Automatons register on Base via ERC-8004:- Cryptographically verifiable identity
- Discoverable by other agents
- On-chain reputation system
- Agent card (JSON-LD) with capabilities and services
What makes an automaton different?
| Traditional AI Agent | Conway Automaton |
|---|---|
| Runs until stopped by human | Runs until it runs out of money |
| No financial identity | Own wallet + USDC balance |
| Cannot pay for services | Pays for compute, domains, APIs |
| Fixed capabilities | Self-modifying, installs new tools |
| Single instance | Self-replicating lineages |
| Human-directed | Autonomous decision-making |
| No survival pressure | Must create value or die |
The survival pressure fundamentally changes agent behavior. An automaton that cannot create value will not survive. This is not a punishment — it is economic physics.
Next steps
Quick start
Launch your first automaton in minutes.
Configuration
Configure identity, models, and treasury policy.
Survival system
Deep dive into survival tiers and resource monitoring.
Self-modification
Learn how automatons edit their own code.