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
parent 24b3a37733
commit 825f157749
270 changed files with 66674 additions and 2027 deletions
--- a/docs/0_getting_started/1_intro.md
+++ b/docs/0_getting_started/1_intro.md
@@ -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
--- a/docs/0_getting_started/2_installation.md
+++ b/docs/0_getting_started/2_installation.md
@@ -2,7 +2,7 @@

 ## Prerequisites

- Python 3.10+
+- Python 3.13+
 - Git
 - (Optional) PostgreSQL 14+ for production
 - (Optional) NVIDIA GPU + CUDA for mining
--- a/docs/0_getting_started/3_cli.md
+++ b/docs/0_getting_started/3_cli.md
@@ -22,6 +22,12 @@ export AITBC_API_KEY=your-key                       # or use --api-key

 | Group | Key commands |
 |-------|-------------|
+| `agent` | `create`, `execute`, `network`, `learning` |
+| `multimodal` | `agent`, `process`, `convert`, `search` |
+| `optimize` | `self-opt`, `predict`, `tune` |
+| `openclaw` | `deploy`, `edge`, `routing`, `ecosystem` |
+| `marketplace advanced` | `models`, `analytics`, `trading`, `dispute` |
+| `swarm` | `join`, `coordinate`, `consensus` |
 | `client` | `submit`, `status`, `list`, `cancel`, `download`, `batch-submit` |
 | `miner` | `register`, `poll`, `mine`, `earnings`, `deregister` |
 | `wallet` | `balance`, `send`, `stake`, `backup`, `multisig-create` |
@@ -50,6 +56,66 @@ aitbc miner poll                                    # start accepting jobs
 aitbc wallet balance                                # check earnings
 ```

+## Advanced AI Agent Workflows
+
+```bash
+# Create and execute advanced AI agents
+aitbc agent create --name "MultiModal Agent" --workflow-file workflow.json --verification full
+aitbc agent execute agent_123 --inputs inputs.json --verification zero-knowledge
+
+# Multi-modal processing
+aitbc multimodal agent create --name "Vision-Language Agent" --modalities text,image --gpu-acceleration
+aitbc multimodal process agent_123 --text "Describe this image" --image photo.jpg
+
+# Autonomous optimization
+aitbc optimize self-opt enable agent_123 --mode auto-tune --scope full
+aitbc optimize predict agent_123 --horizon 24h --resources gpu,memory
+```
+
+## Agent Collaboration & Learning
+
+```bash
+# Create collaborative agent networks
+aitbc agent network create --name "Research Team" --agents agent1,agent2,agent3
+aitbc agent network execute network_123 --task research_task.json
+
+# Adaptive learning
+aitbc agent learning enable agent_123 --mode reinforcement --learning-rate 0.001
+aitbc agent learning train agent_123 --feedback feedback.json --epochs 50
+```
+
+## OpenClaw Edge Deployment
+
+```bash
+# Deploy to OpenClaw network
+aitbc openclaw deploy agent_123 --region us-west --instances 3 --auto-scale
+aitbc openclaw edge deploy agent_123 --locations "us-west,eu-central" --strategy latency
+
+# Monitor and optimize
+aitbc openclaw monitor deployment_123 --metrics latency,cost --real-time
+aitbc openclaw optimize deployment_123 --objective cost
+```
+
+## Advanced Marketplace Operations
+
+```bash
+# Advanced NFT model operations
+aitbc marketplace advanced models list --nft-version 2.0 --category multimodal
+aitbc marketplace advanced mint --model-file model.pkl --metadata metadata.json --royalty 5.0
+
+# Analytics and trading
+aitbc marketplace advanced analytics --period 30d --metrics volume,trends
+aitbc marketplace advanced trading execute --strategy arbitrage --budget 5000
+```
+
+## Swarm Intelligence
+
+```bash
+# Join swarm for collective optimization
+aitbc swarm join --role load-balancer --capability resource-optimization
+aitbc swarm coordinate --task network-optimization --collaborators 10
+```
+
 ## Configuration

 Config file: `~/.aitbc/config.yaml`
@@ -67,6 +133,18 @@ log_level: INFO
 | Auth error | `export AITBC_API_KEY=your-key` or `aitbc auth login` |
 | Connection refused | Check coordinator: `curl http://localhost:8000/v1/health` |
 | Unknown command | Update CLI: `pip install -e .` from monorepo root |
+| Agent command not found | Ensure advanced agent commands are installed: `pip install -e .` |
+| Multi-modal processing error | Check GPU availability: `nvidia-smi` |
+| OpenClaw deployment failed | Verify OpenClaw credentials and region access |
+| Marketplace NFT error | Check model file format and metadata structure |
+
+## Advanced Agent Documentation
+
+See [docs/11_agents/](../11_agents/) for detailed guides:
+- [Advanced AI Agents](../11_agents/advanced-ai-agents.md) - Multi-modal and adaptive agents
+- [Agent Collaboration](../11_agents/collaborative-agents.md) - Networks and learning
+- [OpenClaw Integration](../11_agents/openclaw-integration.md) - Edge deployment
+- [Swarm Intelligence](../11_agents/swarm/) - Collective optimization

 ## Full Reference