Start here: AGI Jobs v0 (v2)

Prefer a friendly webpage? Start the guided welcome → · Commencer en français →

Choose a goal, follow three short steps, and prepare an editable draft without a wallet or installation. Large controls, a larger-text option, examples and a fully translated introductory journey make it easy to begin. The technical setup instructions below are for the next stage.

The guide keeps progress in the same browser tab across refreshes and language changes when browser storage is available. Save an editable draft to reopen it in the guide another day, or download/print a readable request for a person helping you. Examples and clearing actions can be undone while you remain on the page. Advanced planner drafts open in the full planner so none of their details are silently discarded.

This repository contains smart contracts, agent and validator services, operator interfaces, and demonstrations of an agent-work marketplace. Begin locally, inspect the evidence, and then follow the deployment runbooks for your chosen environment.

Current release posture: local development and demonstrations are testable. The contract-size blocker is resolved through fixed implementations and staged deployment. Release remains blocked by unconfigured maintainer signing trust and the integration/configuration requirements in the readiness report. Read the readiness report before preparing any deployment.

Choose your route

Your goal	Open this
Pursue a valuable real mission with Computer Use, strategy discovery and a better formulation	SUCCESSOR Ω Mission Studio · Français · Mission guide
Reproduce bounded keyboard, mouse and screenshot execution before a live worker	Computer Use laboratory and runtime guide
Turn public source text into a traceable evidence brief	Source mission · Français
Rehearse SUCCESSOR Ω missions, proof boundaries and portable knowledge	SUCCESSOR Ω guide
Understand the architecture and its diagrams	Repository overview
Explore a working model demo without a wallet	Tiny Recursive Model setup
Execute a job from creation to local settlement	AURORA walkthrough
Run a three-job local mission with receipts	ASI Take-Off walkthrough
Rehearse release, provider failures, security controls, and commissioning	Production rehearsal
Choose, run, or validate any demo	Demo guide and complete catalog
Find a subsystem manual	Documentation catalog
Run the browser console	Console instructions
Develop agent integration	Gateway guide
Coordinate browser and desktop work	Computer-work setup and recovery, then the executable supplier-desk lab
Inspect a delivery and record review findings	Evidence review guide and local reviewer
Run a validator with explicit review and restart recovery	Validator service guide
Understand owner controls	Operator runbook
Prepare a production deployment	Readiness report, then staged Hardhat deployment

Reproduce the local baseline

Use Node 22.23.3, npm 10.8.2, and Python 3.12. The commands below assume a POSIX shell and an installed nvm. Run from the repository root.

nvm install
nvm use
npm install --global npm@10.8.2
CYPRESS_INSTALL_BINARY=0 npm ci
npm run doctor:node
npm run ci:preflight
npm run compile
npm test

CYPRESS_INSTALL_BINARY=0 defers the browser download during dependency setup. Browser end-to-end tests install their binary separately. Keep optional npm dependencies: Solidity tooling uses platform-specific binaries.

Create an isolated Python environment rather than modifying your system packages:

python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements-python.txt
python -m pip check
PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python -m pytest

To include the neural-model tests, resolve both requirement sets together:

python -m pip install -r requirements-python.txt -r demo/Tiny-Recursive-Model-v0/requirements-core.txt --extra-index-url https://download.pytorch.org/whl/cpu
python -m pip check
OMP_NUM_THREADS=1 MKL_NUM_THREADS=1 PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python -m pytest -m requires_torch

Install the optional model dashboard in its own virtual environment. Its Streamlit dependencies may conflict with the platform API's pinned FastAPI version.

Inspect readiness before releasing

npm run release:check-size
npm run release:audit-dependencies
npm run ci:verify-signers

The size check passes for the modular contracts. The dependency check retains registry audit evidence for every tracked npm and pnpm lockfile and fails on critical/high findings or unavailable evidence; it currently reports unresolved high findings. The signer check intentionally fails on the example signing keys. Read the deployment architecture guide before deploying new controllers. Follow their diagnostic output and the remaining work. Do not interpret a green local test suite, simulated economy, dashboard, or successful compilation as evidence of a deployable or audited production system.

This repository's v2 contract configuration uses the 18-decimal $AGIALPHA token. Confirm the actual token, chain, contract addresses, and deployment manifest for the workflow you run; do not substitute another AGI Jobs repository's settlement assumptions.

Common setup problems

Symptom	Action
Node doctor reports the wrong version	Run `nvm use` at the repository root; check both `node -v` and `npm -v`.
Python dependency conflict or router import error	Use a fresh virtual environment; install all required files in one pip command, then run `python -m pip check`.
Native Python dependency cannot build	Install your platform's C compiler and Python headers; on a managed interpreter select an available compiler with `CC=gcc`.
Missing Solidity artifacts	Run `npm run compile` before contract tests and the size gate.
A live command asks for RPC or wallet configuration	Read that command's runbook. Preview flags differ by command; signing and configuration changes may write on-chain.
Release signer validation fails	Replace the illustrative entries with authorized SSH public keys using the signer guide.