the0 is a open source algorithmic trading platform that empowers developers and traders to create, deploy, and manage trading bots across multiple markets. Whether you're building a simple Dollar Cost Averaging (DCA) strategy or complex multi-asset arbitrage algorithms, the0 provides the infrastructure and tools you need.

⚠️ Early Development: the0 is currently in active development and not yet production ready. We're building towards a stable release and currently at beta - contributions and feedback are welcome!

• 🤖 Custom Bot Development - Build bots in Python or JavaScript with any libraries you prefer
• 📊 Advanced Backtesting - Test strategies with historical data before going live
• ⚡ Real-time Execution - Deploy scheduled or continuous trading bots
• 🐳 Docker Ready - Easy deployment with Docker Compose
• 📈 Analytics Dashboard - Monitor performance and track metrics
• 🌐 Exchange Agnostic - Design your bots to work with any trading platform

Get the0 running locally in under 5 minutes:

• Docker 20.10+ and Docker Compose 2.0+
• At least 4GB RAM available for containers
• Git for cloning the repository

# Clone the repository
git clone https://github.com/yourusername/the0.git
cd the0

# Start all services
cd docker
make up

# Access the platform
open http://localhost:3001  # Frontend
open http://localhost:3000  # API
open http://localhost:9001  # MinIO Console (admin/the0password)

# Navigate to k8s directory
cd k8s

# Single command deployment with local endpoints (experimental)
make minikube-up
make setup-hosts

# Note: Kubernetes deployment is highly experimental and may not work properly

Cloud deployments will be available in the future.

The the0 CLI tool provides a local development interface for managing your bots.

# Clone the repository if you haven't already
git clone https://github.com/alexanderwanyoike/the0.git
cd the0/cli

# Build and install the CLI
make install

# Verify installation
the0 --help

The CLI will be installed to ~/bin/the0. Make sure ~/bin is in your PATH.

• Go 1.21+ - Required for building the CLI
• Git - For cloning the repository

Configure API endpoint for local deployments:

# For Docker Compose deployment
export THE0_API_URL=http://localhost:3000

# For Kubernetes deployment  
export THE0_API_URL=http://api.the0.local:3000

Basic CLI usage:

# Authenticate with the platform
the0 auth login

# Manage bots
the0 bot list
the0 bot create my-bot
the0 bot deploy my-bot

# Custom bot commands
the0 custom-bot upload my-trading-bot.zip
the0 custom-bot status my-trading-bot

For more CLI commands and usage, see the CLI documentation.

the0 is built as a microservices platform that enables algorithmic trading bot development and execution:

graph TB
    subgraph "Users"
        DEV[👨‍💻 Bot Developer<br/>Creates & tests bots]
        TRADER[📊 Trader<br/>Deploys & monitors]
    end
    
    subgraph "the0 Platform"
        subgraph "Client Layer"
            WEB[🌐 Web Dashboard<br/>Next.js 15, React 19<br/>Bot management & monitoring]
            CLI[🛠️ CLI Tool<br/>Go, Cobra<br/>Local development]
        end
        
        subgraph "API Layer"
            API[🚀 API Server<br/>NestJS, TypeScript<br/>REST API & orchestration]
        end
        
        subgraph "Runtime Services"
            BR[⚡ Bot Runner<br/>Go, gRPC<br/>Real-time execution]
            BT[📈 Backtest Runner<br/>Go, gRPC<br/>Historical testing]
            BS[⏰ Bot Scheduler<br/>Go, gRPC<br/>Cron execution]
        end
        
        subgraph "Supporting Services"
            SA[🔍 Security Analyzer<br/>Python, YARA<br/>Code analysis]
            AI[🤖 AI Assistant<br/>Python, FastAPI<br/>Development helper]
        end
        
        subgraph "Data Layer"
            PG[(🐘 PostgreSQL<br/>Users, bots, auth)]
            MONGO[(🍃 MongoDB<br/>Runtime state, logs)]
            NATS[📨 NATS JetStream<br/>Event streaming]
            MINIO[📦 MinIO<br/>Code & log storage]
        end
    end
    
    %% User interactions
    DEV -.->|HTTPS| WEB
    DEV -.->|CLI| CLI
    TRADER -.->|HTTPS| WEB
    
    %% Client to API
    WEB -->|REST + JWT| API
    CLI -->|REST + API Key| API
    API -->|SSE| WEB
    
    %% API to databases
    API -->|SQL| PG
    API -->|Events| NATS
    API -->|S3 API| MINIO
    
    %% Runtime services
    NATS -->|Events| BR
    NATS -->|Events| BT  
    NATS -->|Events| BS
    NATS -->|Events| SA
    
    BR -->|State| MONGO
    BT -->|Jobs| MONGO
    BS -->|Schedules| MONGO
    
    BR -->|Logs| MINIO
    BT -->|Results| MINIO
    SA -->|Analysis| MINIO
    
    %% Styling
    classDef userClass fill:#e1f5fe,stroke:#0277bd,stroke-width:2px
    classDef clientClass fill:#e8f5e8,stroke:#388e3c,stroke-width:2px
    classDef apiClass fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    classDef runtimeClass fill:#fff8e1,stroke:#f57c00,stroke-width:2px
    classDef serviceClass fill:#fce4ec,stroke:#c2185b,stroke-width:2px
    classDef dataClass fill:#e0f2f1,stroke:#00695c,stroke-width:2px
    
    class DEV,TRADER userClass
    class WEB,CLI clientClass
    class API apiClass
    class BR,BT,BS runtimeClass
    class SA,AI serviceClass
    class PG,MONGO,NATS,MINIO dataClass

🌐 Web Dashboard - Next.js frontend for bot management, real-time monitoring, and documentation system

🛠️ CLI Tool - Go-based command-line interface for local bot development, testing, and deployment automation

🚀 API Server - NestJS backend providing REST APIs, JWT authentication, and event orchestration across all services

⚙️ Runtime Services - Specialized Go microservices using master-worker patterns for different execution models:

• Bot Runner: Real-time trading bot execution
• Backtest Runner: Historical strategy validation
• Bot Scheduler: Cron-based scheduled execution

🔍 Security Analyzer - Python service with YARA rules for automated security analysis of user-submitted bot code

🤖 AI Assistant - Standalone service providing AI-powered bot development assistance and code generation. Standalone application for now, but will be integrated into the frontend in the future.

💾 Data Architecture - Multi-database approach:

• PostgreSQL: User accounts, bot definitions, authentication
• MongoDB: Runtime state, job queues, execution logs
• MinIO: Bot code storage, logs, backtest results
• NATS JetStream: Event streaming and service coordination

• 🔒 Isolated: Each bot runs in isolation with basic security checks
• ⚡ Fast: Real-time execution with live market data
• 📈 Scalable: Automatically handles multiple bots and users

the0 doesn't lock you into specific libraries or frameworks. Create bots using:

• Python 3.11+ with any PyPI packages (pandas, numpy, ccxt, etc.)
• JavaScript/Node.js 20+ with any npm packages
• Open Standards: YAML configuration, JSON Schema validation

from typing import Dict, Any
from alpaca.trading.client import TradingClient

def main(id: str, config: Dict[str, Any]) -> Dict[str, Any]:
    """Dollar Cost Averaging bot - buys a fixed amount regularly"""
    
    # Initialize trading client
    client = TradingClient(
        api_key=config["api_key"],
        secret_key=config["secret_key"],
        paper=config.get("paper", True)
    )
    
    # Calculate and execute purchase
    symbol = config["symbol"]
    amount = config["amount"]
    
    # Place market buy order
    order = client.submit_order(
        symbol=symbol,
        notional=amount,
        side=OrderSide.BUY,
        type=OrderType.MARKET,
        time_in_force=TimeInForce.DAY
    )
    
    return {
        "status": "success",
        "message": f"Purchased ${amount} of {symbol}",
        "order_id": order.id
    }

• 📅 Scheduled Bots - Run on cron schedules (daily, weekly, monthly)
• ⚡ Real-time Bots - Continuous execution with live data feeds

• Welcome to the0 - Platform overview
• Custom Bot Development - Build your first bot
• Quick Start Guide - 15-minute DCA bot tutorial

• Docker Setup - Local development environment
• Kubernetes Deployment - Production deployment

• Bot Configuration - Configuration reference
• Testing & Debugging - Development best practices
• Backtesting - Strategy validation

We welcome contributions from developers, traders, and AI enthusiasts! the0 is built by a community that values creativity and innovation.

We encourage the use of AI tools and agents in development:

• ✅ AI Assistants Welcome - Use Claude, ChatGPT, GitHub Copilot, or any AI tools you prefer
• ✅ AI-Generated Code - AI-written code is perfectly fine as long as it's well-tested
• ✅ Creative Solutions - We value innovative approaches and creative problem-solving
• ⚠️ Quality First - Ensure your code is properly tested, regardless of how it was created
• ⚠️ Context Engineering Over Vibe Coding - Use context engineering when contributing with AI rather than "giving into the vibes"

• 🐛 Bug Reports - Found an issue? Let us know!
• 💡 Feature Requests - Have creative ideas for improvements?
• 🔧 Code Contributions - Submit pull requests (AI-assisted or not!)
• 📖 Documentation - Help improve our docs and examples
• 🤖 Bot Templates - Share innovative trading strategies and patterns
• 🎨 Creative Ideas - Think outside the box - we love unconventional approaches!

• 🚀 Innovation Over Convention - Creative solutions are encouraged
• 🧪 Experiment Freely - Try new approaches and share your learnings
• 🤝 Collaborate Openly - Work with both humans and AI to build great software
• ✅ Test Thoroughly - Well-tested code is good code, regardless of its origin
• 📚 Document Well - Help others understand your creative solutions

1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-creative-idea)
3. Build your solution (with or without AI assistance!)
4. Add tests
5. Document your approach and any AI tools used
6. Submit a pull request with a clear description

We believe the best software comes from combining human creativity with AI capabilities. Don't hesitate to experiment and push boundaries!

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• 💬 Discord: Join our community for support
• 📚 Documentation: docs.the0.dev
• 🐙 GitHub Issues: Report bugs or request features