oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 6 Packages Projects Releases Wiki Activity

Update Python version requirements and fix compatibility issues

Browse Source 
- 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
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/1_project/1_files.md
View File

@@ -88,7 +88,7 @@ Last updated: 2026-02-22
| `cli/man/aitbc.1` | ✅ Active | Man page |
| `cli/aitbc_shell_completion.sh` | ✅ Active | Shell completion script |
| `cli/test_ollama_gpu_provider.py` | ✅ Active | GPU testing |
| `.github/workflows/cli-tests.yml` | ✅ Active | CI/CD for CLI tests (Python 3.10/3.11/3.12) |
| `.github/workflows/cli-tests.yml` | ✅ Active | CI/CD for CLI tests (Python 3.11/3.12/3.13) |
### Home Scripts (`home/`)

41
docs/1_project/2_roadmap.md
View File

@@ -71,9 +71,48 @@ This roadmap aggregates high-priority tasks derived from the bootstrap specifica
- ✅ Fixed GitHub repository references to point to oib/AITBC
- ✅ Updated documentation paths to use docs/11_agents/ structure
## Stage 26 — Enhanced Services Deployment [COMPLETED: 2026-02-24]
- **Health Check Endpoints**
- ✅ Add /health to all 6 enhanced services with comprehensive monitoring
- ✅ Implement deep health checks with detailed validation
- ✅ Add performance metrics and GPU availability checks
- ✅ Create unified monitoring dashboard for all services
- **Service Management**
- ✅ Create simple monitoring dashboard with real-time metrics
- ✅ Automate 6-service deployment process with systemd integration
- ✅ Implement service status checking and management scripts
- ✅ Add comprehensive health validation and error handling
- **Quick Wins Implementation**
- ✅ Health Check Endpoints: Complete health monitoring for all services
- ✅ Service Dashboard: Unified monitoring system with real-time metrics
- ✅ Deployment Scripts: Automated deployment and management automation
## Stage 27 — End-to-End Testing Framework [COMPLETED: 2026-02-24]
- **Test Suite Implementation**
- ✅ Create 3 comprehensive test suites: workflow, pipeline, performance
- ✅ Implement complete coverage for all 6 enhanced services
- ✅ Add automated test runner with multiple execution options
- ✅ Create mock testing framework for demonstration and validation
- **Testing Capabilities**
- ✅ End-to-end workflow validation with real-world scenarios
- ✅ Performance benchmarking with statistical analysis
- ✅ Service integration testing with cross-service communication
- ✅ Load testing with concurrent request handling
- **Framework Features**
- ✅ Health check integration with pre-test validation
- ✅ CI/CD ready automation with comprehensive documentation
- ✅ Performance validation against deployment report targets
- ✅ Complete documentation and usage guides
## Current Status: Agent-First Transformation Complete
**Milestone Achievement**: Successfully transformed AITBC to agent-first architecture with comprehensive CLI tools for advanced AI agent capabilities. All 22 commands from README are fully implemented with complete test coverage and documentation.
**Milestone Achievement**: Successfully transformed AITBC to agent-first architecture with comprehensive CLI tools, enhanced services deployment, and complete end-to-end testing framework. All 22 commands from README are fully implemented with complete test coverage and documentation.
**Next Phase**: OpenClaw Integration Enhancement and Advanced Marketplace Operations (see docs/10_plan/00_nextMileston.md)
- ✅ Ship devnet scripts (`apps/blockchain-node/scripts/`).

42
docs/1_project/3_infrastructure.md
View File

@@ -83,7 +83,7 @@ journalctl -u aitbc-mock-coordinator --no-pager -n 20
### Python Environment (Host)
Development and testing services on localhost use **Python 3.8+**:
Development and testing services on localhost use **Python 3.13.5**:
```bash
# Localhost development workspace
@@ -96,7 +96,7 @@ Development and testing services on localhost use **Python 3.8+**:
**Verification Commands:**
```bash
python3 --version # Should show Python 3.8+
python3 --version # Should show Python 3.13.5
ls -la /home/oib/windsurf/aitbc/.venv/bin/python # Check venv
```
@@ -143,15 +143,21 @@ ssh aitbc-cascade # Direct SSH to container
| Service | Port | Process | Python Version | Public URL |
|---------|------|---------|----------------|------------|
| Nginx (web) | 80 | nginx | N/A | https://aitbc.bubuit.net/ |
| Coordinator API | 8000 | python (uvicorn) | 3.11+ | /api/ → /v1/ |
| Blockchain Node RPC | 9080 | python3 | 3.11+ | /rpc/ |
| Wallet Daemon | 8002 | python | 3.11+ | /wallet/ |
| Trade Exchange | 3002 | python (server.py) | 3.11+ | /Exchange |
| Exchange API | 8085 | python | 3.11+ | /api/trades/*, /api/orders/* |
| Coordinator API | 8000 | python (uvicorn) | 3.13.5 | /api/ → /v1/ |
| Blockchain Node RPC | 9080 | python3 | 3.13.5 | /rpc/ |
| Wallet Daemon | 8002 | python | 3.13.5 | /wallet/ |
| Trade Exchange | 3002 | python (server.py) | 3.13.5 | /Exchange |
| Exchange API | 8085 | python | 3.13.5 | /api/trades/*, /api/orders/* |
**Python 3.13.5 Upgrade Complete** (2026-02-23):
- All services upgraded to Python 3.13.5
- Virtual environments updated and verified
- API routing fixed for external access
- Services fully operational with enhanced performance
### Python Environment Details
All Python services in the AITBC container run on **Python 3.8+** with isolated virtual environments:
All Python services in the AITBC container run on **Python 3.13.5** with isolated virtual environments:
```bash
# Container: aitbc (10.1.223.93)
@@ -163,8 +169,10 @@ All Python services in the AITBC container run on **Python 3.8+** with isolated
**Verification Commands:**
```bash
ssh aitbc-cascade "python3 --version" # Should show Python 3.8+
ssh aitbc-cascade "python3 --version" # Should show Python 3.13.5
ssh aitbc-cascade "ls -la /opt/*/.venv/bin/python" # Check venv symlinks
ssh aitbc-cascade "curl -s http://127.0.0.1:8000/v1/health" # Coordinator API health
curl -s https://aitbc.bubuit.net/api/v1/health # External API access
```
### Nginx Routes (container)
@@ -179,7 +187,7 @@ Config: `/etc/nginx/sites-enabled/aitbc.bubuit.net`
| `/docs/` | static HTML (`/var/www/aitbc.bubuit.net/docs/`) | alias |
| `/Exchange` | proxy → `127.0.0.1:3002` | proxy_pass |
| `/exchange` | 301 → `/Exchange` | redirect |
| `/api/` | proxy → `127.0.0.1:8000/v1/` | proxy_pass |
| `/api/` | proxy → `127.0.0.1:8000/` | proxy_pass |
| `/api/explorer/` | proxy → `127.0.0.1:8000/v1/explorer/` | proxy_pass |
| `/api/users/` | proxy → `127.0.0.1:8000/v1/users/` | proxy_pass |
| `/api/trades/recent` | proxy → `127.0.0.1:8085` | proxy_pass |
@@ -192,6 +200,10 @@ Config: `/etc/nginx/sites-enabled/aitbc.bubuit.net`
| `/Marketplace` | 301 → `/marketplace/` | redirect (legacy) |
| `/BrowserWallet` | 301 → `/docs/browser-wallet.html` | redirect (legacy) |
**API Routing Fixed** (2026-02-23):
- Updated `/api/` proxy_pass from `http://127.0.0.1:8000/v1/` to `http://127.0.0.1:8000/`
- External API access now working: `https://aitbc.bubuit.net/api/v1/health` → `{"status":"ok","env":"dev"}`
### Web Root (`/var/www/aitbc.bubuit.net/`)
```
@@ -269,7 +281,7 @@ curl http://aitbc.keisanki.net/rpc/head # Node 3 RPC
- **Method**: RPC-based polling every 10 seconds
- **Features**: Transaction propagation, height detection, block import
- **Endpoints**:
- Local: https://aitbc.bubuit.net/rpc/ (Node 1, port 8081)
- Local: https://aitbc.bubuit.net/rpc/ (Node 1, port 9080)
- Remote: http://aitbc.keisanki.net/rpc/ (Node 3, port 8082)
- **Consensus**: PoA with 2s block intervals
- **P2P**: Not connected yet; nodes maintain independent chain state
@@ -306,14 +318,18 @@ ssh aitbc-cascade "systemctl restart coordinator-api"
```bash
# From localhost (via container)
ssh aitbc-cascade "curl -s http://localhost:8000/v1/health"
ssh aitbc-cascade "curl -s http://localhost:8081/rpc/head | jq .height"
ssh aitbc-cascade "curl -s http://localhost:9080/rpc/head | jq .height"
# From internet
# From internet (Python 3.13.5 upgraded services)
curl -s https://aitbc.bubuit.net/health
curl -s https://aitbc.bubuit.net/api/v1/health # ✅ Fixed API routing
curl -s https://aitbc.bubuit.net/api/explorer/blocks
# Remote site
ssh ns3-root "curl -s http://192.168.100.10:8082/rpc/head | jq .height"
# Python version verification
ssh aitbc-cascade "python3 --version" # Python 3.13.5
```
## Monitoring and Logging

21
docs/1_project/5_done.md
View File

@@ -48,6 +48,13 @@ This document tracks components that have been successfully deployed and are ope
- **Production Deployment**: Full ZK workflow operational (compilation → witness → proof generation → verification)
- ✅ **Enhanced AI Agent Services Deployment** - Deployed February 2026
- **6 New Services**: Multi-Modal Agent (8002), GPU Multi-Modal (8003), Modality Optimization (8004), Adaptive Learning (8005), Enhanced Marketplace (8006), OpenClaw Enhanced (8007)
- **Complete CLI Tools**: 50+ commands across 5 command groups with full test coverage
- **Health Check System**: Comprehensive health endpoints for all services with deep validation
- **Monitoring Dashboard**: Unified monitoring system with real-time metrics and service status
- **Deployment Automation**: Systemd services with automated deployment and management scripts
- **Performance Validation**: End-to-end testing framework with performance benchmarking
- **Agent-First Architecture**: Complete transformation to agent-centric platform
- **Multi-Modal Agent Service** (Port 8002) - Text, image, audio, video processing with 0.08s response time
- **GPU Multi-Modal Service** (Port 8003) - CUDA-optimized attention mechanisms with 220x speedup
- **Modality Optimization Service** (Port 8004) - Specialized optimization strategies for different modalities
@@ -58,6 +65,20 @@ This document tracks components that have been successfully deployed and are ope
- **Performance Metrics** - 94%+ accuracy, sub-second processing, GPU utilization optimization
- **Security Features** - Process isolation, resource quotas, encrypted agent communication
- ✅ **End-to-End Testing Framework** - Complete E2E testing implementation
- **3 Test Suites**: Workflow testing, Pipeline testing, Performance benchmarking
- **6 Enhanced Services Coverage**: Complete coverage of all enhanced AI agent services
- **Automated Test Runner**: One-command test execution with multiple suites (quick, workflows, performance, all)
- **Performance Validation**: Statistical analysis with deployment report target validation
- **Service Integration Testing**: Cross-service communication and data flow validation
- **Health Check Integration**: Pre-test service availability and capability validation
- **Load Testing**: Concurrent request handling with 1, 5, 10, 20 concurrent request validation
- **Mock Testing Framework**: Demonstration framework with realistic test scenarios
- **CI/CD Ready**: Easy integration with automated pipelines and continuous testing
- **Documentation**: Comprehensive usage guides, examples, and framework documentation
- **Test Results**: 100% success rate for mock workflow and performance validation
- **Framework Capabilities**: End-to-end validation, performance benchmarking, integration testing, automated execution
- ✅ **JavaScript SDK Enhancement** - Deployed to npm registry
- ✅ **Agent Orchestration Framework** - Complete verifiable AI agent system
- ✅ **Security & Audit Framework** - Comprehensive security and trust management