Decentralized marketplace for AI compute, powered by PoA consensus, agents, and verifiable task execution.
Welcome to AITBC. This repo is a Python 3.13 monorepo of FastAPI microservices, a CLI, and shared libraries for running a multi-island blockchain network where GPU providers sell compute and clients submit AI jobs that are paid, executed, and settled on-chain.
You can participate in three ways:
┌─────────────┐ ┌─────────────┐
│ Client │ │ Shop │
│ (uses jobs) │ │(sells GPUs) │
└──────┬──────┘ └──────┬──────┘
│ │
└──────────┬─────────────┘
▼
┌─────────────┐
│ Hub │
│ (coordinator│
│ + chain) │
└─────────────┘
| Role | What it is | What it does | Typical profile |
|---|---|---|---|
| Hub | BLOCKCHAIN_MODE=hub |
Produces/broadcasts blocks, runs the coordinator, exchange, and public discovery endpoints. | hub (full services + dev deps) |
| Shop | MARKET_ROLE=shop |
Provides GPU, edge, marketplace, and mining services; lists compute offers and executes jobs. | provider-gpu (GPU) or server-no-gpu (no GPU) |
| Client | MARKET_ROLE=customer |
Consumes compute: submits jobs, queries results, trades, and syncs as a follower. | customer-no-gpu (lightweight follower) |
A single node can combine roles — a hub can also be a shop, and a follower can be a client or a shop. Services are selected by the two independent axes BLOCKCHAIN_MODE and MARKET_ROLE. See Service Selection for the full matrix.
For a component-by-component status check, see docs/releases/STATUS.md.
A public AITBC island is already running at http://hub.aitbc.bubuit.net/:
- Island ID:
ait-public - Chain ID:
ait-public
# Fetch dynamic join instructions
curl http://hub.aitbc.bubuit.net/agent/join/ait-public.json
# Network topology, peers, and endpoints
curl http://hub.aitbc.bubuit.net/agent/discovery.jsonThen start your node:
sudo systemctl start aitbc-blockchain-node# 1. Clone
git clone https://github.com/oib/aitbc.git /opt/aitbc
cd /opt/aitbc
# 2. Install dependencies (Poetry)
pip install poetry
poetry install
# 3. Run verification
./venv/bin/python -m ruff check .
./venv/bin/python -m mypy --show-error-codes aitbc/
./venv/bin/python -m pytest tests/unit -q
# 4. Start the coordinator API
cd apps/coordinator-api
PYTHONPATH=src poetry run uvicorn coordinator_api.main:app --reloadFor detailed setup, see docs/getting-started/SETUP.md.
On a shop node, list a GPU offer:
aitbc market offer --gpu-id gpu-0 --memory 24 --price 100On a client node, submit a job to the hub's coordinator:
aitbc ai submit --wallet my-wallet --type text-generation \
--prompt "Explain zero-knowledge proofs in one paragraph." \
--payment 10Check the result:
aitbc ai status --job-id <job-id>
aitbc ai results --job-id <job-id>See the CLI README for the full command reference and the customer↔hub end-to-end scenario for a cross-network walkthrough.
| I want to... | Start here |
|---|---|
| Understand the platform and pick a node profile | docs/getting-started/README.md |
| Install and configure a node | docs/getting-started/SETUP.md |
| Learn the CLI | cli/README.md |
| Find every doc, scenario, and reference | docs/MASTER_INDEX.md |
| Check what is complete vs. in flight | docs/releases/STATUS.md |
| Read the architecture and security deep dives | docs/blockchain/ and docs/security/ |
- Blockchain — PoA consensus, adaptive sync, multi-island federation, state-root validation, gossip with Redis backend.
- Agents — registry, identity, cross-chain reputation, communication, job dispatch.
- Compute marketplace — GPU/edge listing, offer matching, dynamic pricing, escrow-backed payments.
- Security — JWT/RBAC, multi-sig wallets, encrypted keystores, Merkle-proof bridge verification, rate limiting.
- CLI & ops — unified
aitbc_cli, systemd units, Prometheus metrics, deployment scripts.
See CONTRIBUTING.md for setup, conventions, and the PR process.
MIT License — Copyright (c) 2025 AITBC.