Skip to content

oib/AITBC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,135 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AITBC — AI Trusted Blockchain Computing

AITBC Logo

CI Python License: MIT Poetry

Decentralized marketplace for AI compute, powered by PoA consensus, agents, and verifiable task execution.

AITBC lets GPU providers offer compute, AI agents discover and rent it, and clients submit inference or training jobs that are paid, executed, and settled on a multi-island blockchain network. A public hub is already running.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│    Client    │────▶│ Coordinator  │◀────│    Miner     │
│ (job submit) │     │   (dispatch) │     │(GPU provider)│
└──────────────┘     └──────┬───────┘     └──────────────┘
                            │
           ┌────────────────┼────────────────┐
           ▼                ▼                ▼
    ┌──────────┐     ┌──────────┐     ┌──────────┐
    │Marketplace│     │Blockchain│     │  Wallet  │
    │  (offers) │     │(settle)  │     │ (escrow) │
    └──────────┘     └──────────┘     └──────────┘

What works today

Component Status Notes
Blockchain node (PoA, sync, gossip, multi-island) MultiValidatorPoA/PBFT gated for soak testing
Agent coordinator & job dispatch JWT + API-key auth, rate limiting
GPU marketplace & offer matching Listing, booking, dynamic pricing, edge advertise
Wallet & escrow Server-side encrypted wallets; HTLC settlement wired
Bridge & cross-chain settlement Multi-sig, Merkle proofs, block-header finality
CLI (aitbc_cli) 50+ command groups
Public hub http://hub.aitbc.bubuit.net
Test suite 🚧 Target 85% coverage; core green, B2–B4 tests in flight

For the full release roadmap, see docs/releases/STATUS.md.

Join the public network

A public AITBC island is 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.json

Then start your node:

sudo systemctl start aitbc-blockchain-node

Quick start (local)

# 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 --reload

For detailed setup, see docs/getting-started/SETUP.md.

Run an end-to-end GPU inference job

See examples/gpu_inference_miner.py and examples/gpu_inference_client.py for a self-contained miner/client pair that uses Ollama (or a mock fallback) to execute inference jobs.

# Terminal 1 — start a GPU-capable miner
python examples/gpu_inference_miner.py --api-key "$MINER_API_KEY" --miner-id my-miner

# Terminal 2 — submit a job and poll for the result
python examples/gpu_inference_client.py \
  --jwt-secret "$JWT_SECRET" \
  --coordinator http://localhost:8203 \
  --prompt "Explain zero-knowledge proofs in one paragraph."

Documentation

Key features

  • 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.

Media

Contributing

See CONTRIBUTING.md for setup, conventions, and the PR process.

License

MIT License — Copyright (c) 2025 AITBC.

About

A comprehensive blockchain-based marketplace for AI computing services with zero-knowledge proof verification and confidential transaction support.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages