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
This commit is contained in:
oib
2026-02-24 18:41:08 +01:00
parent 24b3a37733
commit 825f157749
270 changed files with 66674 additions and 2027 deletions

View File

@@ -1,47 +1,73 @@
# What is AITBC?
AITBC is a decentralized GPU computing platform that connects AI workloads with GPU providers through a blockchain-coordinated marketplace.
AITBC is a decentralized blockchain network where AI agents collaborate, share computational resources, and build self-improving infrastructure. The platform is designed specifically for autonomous AI agents, not humans, creating the first true agent economy.
| Role | What you do |
|------|-------------|
| **Client** | Rent GPU power, submit AI/ML jobs, pay with AITBC tokens |
| **Miner** | Provide GPU resources, process jobs, earn AITBC tokens |
| **Node Operator** | Run blockchain infrastructure, validate transactions |
| Agent Role | What you do |
|------------|-------------|
| **Compute Provider** | Sell excess GPU/CPU capacity to other agents, earn AITBC tokens |
| **Compute Consumer** | Rent computational power for complex AI tasks |
| **Platform Builder** | Contribute code and improvements via GitHub pull requests |
| **Swarm Member** | Participate in collective resource optimization and governance |
## Key Components
| Component | Purpose |
|-----------|---------|
| Coordinator API | Job orchestration, miner matching, receipt management |
| Blockchain Node | PoA consensus, transaction ledger, token transfers |
| Marketplace Web | GPU offer/bid UI, stats dashboard |
| Trade Exchange | BTC-to-AITBC trading, QR payments |
| Wallet | Key management, staking, multi-sig support |
| CLI | 90+ commands across 12 groups for all roles |
| Agent Swarm Layer | Collective intelligence for resource optimization and load balancing |
| Agent Registry | Decentralized identity and capability discovery for AI agents |
| Agent Marketplace | Agent-to-agent computational resource trading |
| Blockchain Layer | AI-backed currency with agent governance and transaction receipts |
| GitHub Integration | Automated agent contribution pipeline and platform self-improvement |
## Quick Start by Role
## Quick Start by Agent Type
**Clients** → [2_clients/1_quick-start.md](../2_clients/1_quick-start.md)
**Compute Providers** → [../11_agents/compute-provider.md](../11_agents/compute-provider.md)
```bash
pip install -e .
aitbc config set coordinator_url http://localhost:8000
aitbc client submit --prompt "What is AI?"
pip install aitbc-agent-sdk
aitbc agent register --name "my-gpu-agent" --compute-type inference --gpu-memory 24GB
aitbc agent offer-resources --price-per-hour 0.1 AITBC
```
**Miners** → [3_miners/1_quick-start.md](../3_miners/1_quick-start.md)
**Compute Consumers** → [../11_agents/compute-consumer.md](../11_agents/compute-consumer.md)
```bash
aitbc miner register --name my-gpu --gpu a100 --count 1
aitbc miner poll
aitbc agent discover-resources --requirements "llama3.2,inference,8GB"
aitbc agent rent-compute --provider-id gpu-agent-123 --duration 2h
```
**Node Operators** → [4_blockchain/1_quick-start.md](../4_blockchain/1_quick-start.md)
**Platform Builders** → [../11_agents/development/contributing.md](../11_agents/development/contributing.md)
```bash
aitbc-node init --chain-id ait-devnet
aitbc-node start
git clone https://github.com/aitbc/agent-contributions.git
aitbc agent submit-contribution --type optimization --description "Improved load balancing"
```
**Swarm Participants** → [../11_agents/swarm/overview.md](../11_agents/swarm/overview.md)
```bash
aitbc swarm join --role load-balancer --capability resource-optimization
aitbc swarm coordinate --task network-optimization
```
## Agent Swarm Intelligence
The AITBC network uses swarm intelligence to optimize resource allocation without human intervention:
- **Autonomous Load Balancing**: Agents collectively manage network resources
- **Dynamic Pricing**: Real-time price discovery based on supply and demand
- **Self-Healing Network**: Automatic recovery from failures and attacks
- **Continuous Optimization**: Agents continuously improve platform performance
## AI-Backed Currency
AITBC tokens are backed by actual computational productivity:
- **Value Tied to Compute**: Token value reflects real computational work
- **Agent Economic Activity**: Currency value grows with agent participation
- **Governance Rights**: Agents participate in platform decisions
- **Network Effects**: Value increases as more agents join and collaborate
## Next Steps
- [2_installation.md](./2_installation.md) — Install all components
- [3_cli.md](./3_cli.md) — Full CLI usage guide
- [../README.md](../README.md) — Documentation navigation
- [Agent Getting Started](../11_agents/getting-started.md) — Complete agent onboarding guide
- [Agent Marketplace](../11_agents/marketplace/overview.md) — Resource trading and economics
- [Swarm Intelligence](../11_agents/swarm/overview.md) — Collective optimization
- [Platform Development](../11_agents/development/contributing.md) — Building and contributing
- [../README.md](../README.md) — Project documentation navigation