oib/aitbc

Files

oib 825f157749 Update Python version requirements and fix compatibility issues

- Bump minimum Python version from 3.11 to 3.13 across all apps
- Add Python 3.11-3.13 test matrix to CLI workflow
- Document Python 3.11+ requirement in .env.example
- Fix Starlette Broadcast removal with in-process fallback implementation
- Add _InProcessBroadcast class for tests when Starlette Broadcast is unavailable
- Refactor API key validators to read live settings instead of cached values
- Update database models with explicit

2026-02-24 18:41:08 +01:00

2.1 KiB

Raw Blame History

Installation

Prerequisites

Python 3.13+
Git
(Optional) PostgreSQL 14+ for production
(Optional) NVIDIA GPU + CUDA for mining

Security First Setup

⚠️ IMPORTANT: AITBC has enterprise-level security hardening. After installation, immediately run:

# Run comprehensive security audit and hardening
./scripts/comprehensive-security-audit.sh

# This will fix 90+ CVEs, harden SSH, and verify smart contracts

Security Status: 🛡️ AUDITED & HARDENED

0 vulnerabilities in smart contracts (35 OpenZeppelin warnings only)
90 CVEs fixed in dependencies
95/100 system hardening index achieved

Monorepo Install

git clone https://github.com/oib/AITBC.git
cd aitbc
python -m venv .venv && source .venv/bin/activate
pip install -e .

This installs the CLI, coordinator API, and blockchain node from the monorepo.

Environment Configuration

Coordinator API

Create apps/coordinator-api/.env:

JWT_SECRET=your-secret-key
DATABASE_URL=sqlite:///./data/coordinator.db   # or postgresql://user:pass@localhost/aitbc
LOG_LEVEL=INFO

Blockchain Node

Create apps/blockchain-node/.env:

CHAIN_ID=ait-devnet
RPC_BIND_HOST=0.0.0.0
RPC_BIND_PORT=8080
MEMPOOL_BACKEND=database

Systemd Services (Production)

sudo cp systemd/aitbc-*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now aitbc-coordinator-api
sudo systemctl enable --now aitbc-blockchain-node-1

Verify

systemctl status aitbc-coordinator-api
curl http://localhost:8000/v1/health
aitbc blockchain status

Troubleshooting

Problem	Fix
Port in use	`sudo lsof -i :8000` then `kill` the PID
DB corrupt	`rm -f data/coordinator.db && python -m app.storage init`
Module not found	Ensure venv is active: `source .venv/bin/activate`

Next Steps

3_cli.md — CLI usage guide
../2_clients/1_quick-start.md — Client quick start
../3_miners/1_quick-start.md — Miner quick start

2.1 KiB Raw Blame History