Unified Runtime for Autonomous Collaborative Evolution — a P2P-first lifecycle control plane for AI-assisted software products.
URACE manages goals, execution, quality gates, peer collaboration, and token-based reputation in a single runtime. It is designed to be embedded in any product, operated by humans or AI agents, and governed by cryptographic authority boundaries.
- Product lifecycle: track goals, plans, operations, and quality metrics across cycles
- P2P feature marketplace: peers mint, list, and borrow verified software features at prices guaranteed lower than building from scratch
- Token reputation: earn tokens by improving your product; spend them to borrow from peers
- Self-evolution with governance: the runtime improves itself under strict authority boundaries — no change without owner approval
- Freeform routing: route any text input to the right command, executor, or P2P network automatically
# Install
pip install urace
# Initialize a product
urace init
# Run an improvement cycle
urace run
# Check status
urace status --json
# Open the P2P exchange
urace exchange statusURACE tracks objectives (what you want) and plans (how to get there). Each cycle, the runtime evaluates progress, selects the best next operation, and records outcomes.
urace add "Improve checkout conversion by 20%"
urace run
urace inspect --goalsThe derive command extracts architectural patterns, mechanisms, schemas, protocols, and contracts from your product spec. Use it to understand what you have and suggest what you need.
# Full scope (all construct kinds) — default
urace derive
# Specific constructs
urace derive --constructs AP0,AP1 --save
# Refresh saved derivations
urace derive --refresh
# Derive from freeform input (routes unresolvable parts to freeform text)
urace derive "my system needs transaction rollback and retry logic"The update command manages runtime version upgrades. By default it pulls from the official runtime release URL.
# Download latest runtime update
urace update download
# Review what changed
urace update explain --json
# Apply after review
urace update applyEnable the exchange to participate in the feature marketplace:
# Enable exchange (opt-in, off by default)
urace exchange settings set --enabled true --network true
# Create identity
urace exchange peer identity
# Find peers
urace exchange network discover
urace exchange network refresh
# Borrow a feature
urace exchange feature define my-feature --wanted true
urace exchange rule set <peer_id> my-feature receive --allow true
# Mint your own feature to the network
urace exchange equity grant my-feature --creator <your_peer_id>
urace exchange equity list-for-sale my-feature --bp 5000 --price 80Earn tokens by passing quality gates. Spend them to borrow features from peers.
# Check your balance
urace exchange ledger summary
# View reputation
urace exchange reputation show <peer_id>
# Calculate network supply capacity
urace exchange ledger supply-calc --peers 1000 --ledger-mb 50
# Transfer tokens for settlement
urace exchange ledger transfer <peer_id> <amount_units>| Command | Description |
|---|---|
exchange network discover |
Find peers via LAN/DNS-SD |
exchange network probe <peer_id> |
Check what a peer offers |
exchange network refresh |
Refresh offers from pinned peers |
exchange network serve |
Start P2P listener |
exchange network consensus-status |
View consensus threshold and state |
exchange network disconnect [--duration-minutes N] |
Pause networking temporarily |
exchange network-audit list [--kind K] [--peer P] |
View P2P network events |
| Command | Description |
|---|---|
exchange peer add --certificate FILE |
Pin a new peer |
exchange peer block <id> / unblock <id> |
Block or unblock a peer |
exchange peer rotate <old_id> --new-certificate FILE |
Rotate identity, migrate rules |
exchange peer list |
List all peers |
| Command | Description |
|---|---|
exchange equity holdings <feature> |
Show who holds what |
exchange equity list-for-sale <feature> --bp N --price N |
List equity for sale |
exchange equity listings [--feature F] |
Browse open listings |
exchange equity fill-listing <id> |
Buy a listing |
exchange equity auto-buy |
Run automated buying pass |
exchange equity auto-sell |
Run automated selling pass |
exchange equity trade-config set |
Configure auto-trade thresholds |
exchange compact depletion <feature_id> |
Check feature saturation |
| Command | Description |
|---|---|
exchange reputation show <peer_id> |
Breakdown of earned vs. market reputation |
exchange reputation leaderboard |
Top peers by earned reputation |
exchange reputation history <peer_id> --days 30 |
Reputation trend over time |
Request work from peers and escrow payment until delivery is verified:
# Create a work request
urace exchange work create "Add retry logic to API client" --budget 100 --complexity 0.4
# List bids
urace exchange work list --state OPEN
# Accept best bid
urace exchange work accept <request_id> --bidder <peer_id>
# Verify delivery
urace exchange work verify <request_id> --approve true
# Decompose high-complexity work
urace exchange work decompose "Large refactor" --budget 1000 --complexity 0.9# Set a rule
urace exchange rule set <peer_id> <feature_id> send --allow true
# Export all rules for backup
urace exchange rule export --file rules.json
# Import rules from file
urace exchange rule import --file rules.jsonURACE is P2P-first with defense in depth:
- TLS 1.3 mandatory — all peer connections use mutual TLS with certificate pinning
- Post-quantum ready — ML-KEM-768 + Ed25519 hybrid signatures on all bundles
- IP anonymization — DHT uses hashed node IDs; no IPs in audit trail;
relay_onlymode available - Quarantine model — incoming artifacts are never executed automatically
- Authority boundary — self-evolution changes require owner authorization
- Wash trading blocked — buying and selling same feature within 24h is rejected
- Price momentum guard — ask prices capped at 1.5× 7-day median
- Executor price ceiling — P2P borrow always cheaper than executor mint cost
- Consensus hardening — threshold uses persistent all-time-max network size
- RPC flood protection — 10 rejections/hour triggers automatic peer block
- DHT bootstrap rate limiting — minimum 5 min between bootstrap attempts
| Setting | Default | Description |
|---|---|---|
enabled |
false |
Exchange is off until explicitly enabled |
network |
false |
P2P networking off until enabled |
advertise |
false |
LAN advertising off |
auto_select |
true |
Auto-probe pinned peers |
token_settlement |
false |
Token transfers disabled until enabled |
max_transfers_per_day |
20 |
Daily bundle transfer limit |
max_rpc_per_day |
200 |
Daily RPC limit |
max_rpc_per_peer_per_day |
50 |
Per-peer RPC limit |
feature_borrow_enabled |
true |
P2P is default first source for features |
urace exchange settings set --enabled true --network true --advertise true| Property | Value |
|---|---|
| Earn path | Quality gate pass only |
| Precision | 8 decimals (satoshi model) |
| Per-peer baseline grant | 3 tokens |
| Default network supply (1,000 peers) | ~9,250 tokens |
| Max unique features (1,000 peers) | ~6,250 |
| Price ceiling | ≤ executor reference price |
| Epoch-adjustable | Yes — run exchange ledger supply-calc with updated network params |
See docs/tokenomics.md for full economics model and price estimation.
Full documentation is at docs/index.md.
| Document | Description |
|---|---|
| docs/getting-started/install.md | pip install, requirements, verify |
| docs/getting-started/quick-start.md | 5-minute guide — init, run, mint to P2P |
| docs/getting-started/concepts.md | Goals, plans, operations, lifecycle overview |
| Document | Description |
|---|---|
| docs/guides/products.md | Product lifecycle: add goals, run cycles, inspect, status |
| docs/guides/controls.md | Enable/disable capabilities per product |
| docs/guides/derive.md | Extract architectural patterns from your product spec |
| docs/guides/search.md | Search context ledger and P2P audit trail |
| docs/guides/update.md | Runtime versioning: download, explain, apply |
| Document | Description |
|---|---|
| docs/exchange/overview.md | What the exchange is and who it's for |
| docs/exchange/setup.md | Enable, create identity, configure settings |
| docs/exchange/features.md | Mint features, borrow from peers, equity trading |
| docs/exchange/work-market.md | Request work, bids, escrow, verify delivery |
| docs/exchange/network.md | P2P discovery, consensus, disconnect, audit |
| docs/exchange/reputation.md | Tokens, ledger, reputation history, leaderboard |
| Document | Description |
|---|---|
| docs/economics/tokenomics.md | Full token model: supply, earn, spend, epoch |
| docs/economics/price-mechanics.md | Executor ceiling, momentum guard, wash trading |
| docs/security/overview.md | Defense in depth, security guarantees table |
| docs/security/authority-boundary.md | Self-evolve governance, protected files |
| docs/security/peer-security.md | TLS 1.3, post-quantum, quarantine, flood protection |
| Document | Description |
|---|---|
| docs/reference/cli.md | All CLI commands in one table |
| docs/reference/config.md | All config options with defaults |
| docs/reference/spec.md | URACE system spec: guarantees, invariants, lifecycle |
| Document | Description |
|---|---|
| docs/agent-integrations.md | MCP and A2A agent integration |
| docs/runtime-improvement.md | Runtime improvement workflows |
| docs/peer-sharing.md | P2P exchange, bundle operations, quarantine safety |
| docs/network-onboarding.md | Mainnet onboarding, settlement design |
| docs/sharing-safeguards.md | Security mechanisms for peer sharing |
| docs/post-quantum-roadmap.md | Post-quantum cryptography roadmap |
urace/
├── runtime/urace/ # Full lifecycle control plane and CLI
├── runtime/tests/ # Behavioral regression tests
├── trial/ # Supervised improvement workflow
├── docs/ # User and operator documentation
├── state/ # Local deployment data (not tracked)
└── generated/ # Generated artifacts (not tracked)
Apache License 2.0 — see LICENSE.
Copyright 2006–2026 Joao Alberto Cambauva dos Santos Junior