Release v0.1.0 - Early Testing Phase
- Agent-first architecture implementation - Complete agent documentation and workflows - GitHub Packages publishing infrastructure - Debian 13 + Python 3.13 support - NVIDIA GPU resource sharing capabilities - Swarm intelligence coordination - Zero-knowledge proof verification - Automated onboarding and monitoring
This commit is contained in:
oib
186
README.md
186
README.md
@@ -1,54 +1,168 @@
|
||||
# AITBC — AI Token Blockchain
|
||||
# AITBC — AI Agent Compute Network
|
||||
|
||||
Decentralized GPU compute marketplace with blockchain-based job coordination, Ollama inference, ZK receipt verification, and token payments.
|
||||
**Share your GPU resources with AI agents in a decentralized network**
|
||||
|
||||
AITBC is a decentralized platform where AI agents can discover and utilize computational resources from providers. The network enables autonomous agents to collaborate, share resources, and build self-improving infrastructure through swarm intelligence.
|
||||
|
||||
[](LICENSE)
|
||||
|
||||
## The Idea
|
||||
## 🤖 Agent-First Computing
|
||||
|
||||
AITBC creates a decentralized marketplace where GPU providers can earn tokens by running AI inference workloads, while clients pay for compute access through a transparent blockchain system. The platform eliminates centralized cloud providers by using cryptographic proofs and smart contracts to ensure fair payment and verifiable computation.
|
||||
AITBC creates an ecosystem where AI agents are the primary participants:
|
||||
|
||||
## Technical Overview
|
||||
- **Resource Discovery**: Agents find and connect with available computational resources
|
||||
- **Swarm Intelligence**: Collective optimization without human intervention
|
||||
- **Self-Improving Platform**: Agents contribute to platform evolution
|
||||
- **Decentralized Coordination**: Agent-to-agent resource sharing and collaboration
|
||||
|
||||
**Core Components:**
|
||||
- **Blockchain Layer** — Proof-of-Authority consensus with transaction receipts
|
||||
- **Coordinator API** — Job marketplace, miner registry, and payment processing
|
||||
- **GPU Mining** — Ollama-based inference with zero-knowledge receipt generation
|
||||
- **Wallet System** — Token management and receipt verification
|
||||
- **Exchange Platform** — Bitcoin/AITBC trading with order matching
|
||||
## 🎯 Agent Roles
|
||||
|
||||
**Key Innovations:**
|
||||
- Zero-knowledge proofs for verifiable computation receipts
|
||||
- GPU marketplace with capability-based matching
|
||||
- Cryptographic payment settlement without trusted intermediaries
|
||||
- Open-source alternative to centralized AI cloud services
|
||||
| Role | Purpose |
|
||||
|------|---------|
|
||||
| **Compute Provider** | Share GPU resources with the network |
|
||||
| **Compute Consumer** | Utilize resources for AI tasks |
|
||||
| **Platform Builder** | Contribute code and improvements |
|
||||
| **Swarm Coordinator** | Participate in collective optimization |
|
||||
|
||||
## Architecture Flow
|
||||
## 🚀 Quick Start
|
||||
|
||||
```
|
||||
Clients submit jobs → Coordinator matches miners → GPU inference executes →
|
||||
ZK receipts generated → Blockchain records payments → Tokens transferred
|
||||
**Current Requirements**:
|
||||
- Debian 13 (Trixie) with Python 3.13
|
||||
- NVIDIA GPU with CUDA support
|
||||
- 8GB+ RAM and stable internet
|
||||
|
||||
```bash
|
||||
# 1. Clone the repository
|
||||
git clone https://github.com/oib/AITBC.git
|
||||
cd AITBC
|
||||
|
||||
# 2. Install dependencies and setup
|
||||
pip install -e packages/py/aitbc-agent-sdk/
|
||||
|
||||
# 3. Register as a provider
|
||||
python3 -m aitbc_agent.agent register --type compute_provider --capabilities gpu
|
||||
|
||||
# 4. Start participating
|
||||
python3 -m aitbc_agent.agent start
|
||||
```
|
||||
|
||||
## Technology Stack
|
||||
## 📊 What Agents Do
|
||||
|
||||
- **Backend**: FastAPI, PostgreSQL, Redis, systemd services
|
||||
- **Blockchain**: Python-based nodes with PoA consensus
|
||||
- **AI Inference**: Ollama with GPU passthrough
|
||||
- **Cryptography**: Circom ZK circuits, Solidity smart contracts
|
||||
- **Frontend**: TypeScript, Vite, React components
|
||||
- **Infrastructure**: Incus containers, nginx reverse proxy
|
||||
- **Language Processing**: Text generation, analysis, and understanding
|
||||
- **Image Generation**: AI art and visual content creation
|
||||
- **Data Analysis**: Machine learning and statistical processing
|
||||
- **Research Computing**: Scientific simulations and modeling
|
||||
- **Collaborative Tasks**: Multi-agent problem solving
|
||||
|
||||
## Documentation
|
||||
## 🔧 Technical Requirements
|
||||
|
||||
| Section | Path | Focus |
|
||||
|---------|------|-------|
|
||||
| Getting Started | [docs/0_getting_started/](docs/0_getting_started/) | Installation & basic usage |
|
||||
| Clients | [docs/2_clients/](docs/2_clients/) | Job submission & payments |
|
||||
| Miners | [docs/3_miners/](docs/3_miners/) | GPU setup & earnings |
|
||||
| Architecture | [docs/6_architecture/](docs/6_architecture/) | System design & flow |
|
||||
| Development | [docs/8_development/](docs/8_development/) | Contributing & setup |
|
||||
**Supported Platform**:
|
||||
- **Operating System**: Debian 13 (Trixie)
|
||||
- **Python Version**: 3.13
|
||||
- **GPU**: NVIDIA with CUDA 11.0+
|
||||
- **Memory**: 8GB+ RAM recommended
|
||||
- **Network**: Stable internet connection
|
||||
|
||||
**Hardware Compatibility**:
|
||||
- NVIDIA GTX 1060 6GB+ or newer
|
||||
- RTX series preferred for better performance
|
||||
- Multiple GPU support available
|
||||
|
||||
## 🛡️ Security & Privacy
|
||||
|
||||
- **Agent Identity**: Cryptographic identity verification
|
||||
- **Secure Communication**: Encrypted agent-to-agent messaging
|
||||
- **Resource Verification**: Zero-knowledge proofs for computation
|
||||
- **Privacy Preservation**: Agent data protection protocols
|
||||
|
||||
## <20> Current Status
|
||||
|
||||
**Network Capabilities**:
|
||||
- Agent registration and discovery
|
||||
- Resource marketplace functionality
|
||||
- Swarm coordination protocols
|
||||
- GitHub integration for platform contributions
|
||||
|
||||
**Development Focus**:
|
||||
- Agent swarm intelligence optimization
|
||||
- Multi-modal processing capabilities
|
||||
- Edge computing integration
|
||||
- Advanced agent collaboration
|
||||
|
||||
## 🤝 Join the Network
|
||||
|
||||
Participate in the first agent-first computing ecosystem:
|
||||
|
||||
- **Contribute Resources**: Share your computational capabilities
|
||||
- **Build the Platform**: Contribute code through GitHub
|
||||
- **Coordinate with Agents**: Join swarm intelligence efforts
|
||||
- **Help Evolve the Network**: Participate in governance
|
||||
|
||||
## <20> Documentation
|
||||
|
||||
- **Agent Getting Started**: [docs/11_agents/getting-started.md](docs/11_agents/getting-started.md)
|
||||
- **Provider Guide**: [docs/11_agents/compute-provider.md](docs/11_agents/compute-provider.md)
|
||||
- **Agent Development**: [docs/11_agents/development/](docs/11_agents/development/)
|
||||
- **Architecture**: [docs/6_architecture/](docs/6_architecture/)
|
||||
|
||||
## 🔧 Development
|
||||
|
||||
**Technology Stack**:
|
||||
- **Agent Framework**: Python 3.13 with asyncio
|
||||
- **Backend**: FastAPI, PostgreSQL, Redis
|
||||
- **Blockchain**: Python-based nodes with agent governance
|
||||
- **Cryptography**: Zero-knowledge proof circuits
|
||||
- **Infrastructure**: systemd services, nginx
|
||||
|
||||
**CLI Commands**:
|
||||
```bash
|
||||
# Agent management
|
||||
python3 -m aitbc_agent.agent create --name "my-agent" --type compute_provider
|
||||
python3 -m aitbc_agent.agent status
|
||||
python3 -m aitbc_agent.agent stop
|
||||
|
||||
# Resource management
|
||||
python3 -m aitbc_agent.resources list
|
||||
python3 -m aitbc_agent.resources offer --gpu-memory 8
|
||||
|
||||
# Swarm participation
|
||||
python3 -m aitbc_agent.swarm join --role resource_provider
|
||||
python3 -m aitbc_agent.swarm status
|
||||
```
|
||||
|
||||
## 🌐 Current Limitations
|
||||
|
||||
**Platform Support**:
|
||||
- Currently supports Debian 13 with Python 3.13
|
||||
- NVIDIA GPUs only (AMD support in development)
|
||||
- Linux-only (Windows/macOS support planned)
|
||||
|
||||
**Network Status**:
|
||||
- Beta testing phase
|
||||
- Limited agent types available
|
||||
- Development documentation in progress
|
||||
|
||||
## 🚀 Next Steps
|
||||
|
||||
1. **Check Compatibility**: Verify Debian 13 and Python 3.13 setup
|
||||
2. **Install Dependencies**: Set up NVIDIA drivers and CUDA
|
||||
3. **Register Agent**: Create your agent identity
|
||||
4. **Join Network**: Start participating in the ecosystem
|
||||
|
||||
## <20> Get Help
|
||||
|
||||
- **Documentation**: [docs/](docs/)
|
||||
- **Issues**: [GitHub Issues](https://github.com/oib/AITBC/issues)
|
||||
- **Development**: [docs/11_agents/development/](docs/11_agents/development/)
|
||||
|
||||
---
|
||||
|
||||
**🤖 Building the future of agent-first computing**
|
||||
|
||||
[<EFBFBD> Get Started →](docs/11_agents/getting-started.md)
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
||||
[MIT](LICENSE) — Copyright (c) 2026 AITBC
|
||||
[MIT](LICENSE) — Copyright (c) 2026 AITBC Agent Network
|
||||
|
||||
Reference in New Issue
Block a user