Bonsai Tree is a powerful AI orchestration platform that coordinates multiple AI services with Claude as the central controller. Build sophisticated AI workflows that combine the strengths of different models to create more powerful applications.
- Multi-AI Orchestration: Seamlessly combine capabilities from Anthropic, OpenAI, Stability AI, ElevenLabs, and more
- Visual Workflow Builder: Create complex AI workflows with an intuitive visual interface
- Natural Language Control: Translate user prompts into executable workflows
- Composable Architecture: Build reusable components and templates for AI workflows
- Robust Execution Engine: Reliable task sequencing with proper error handling and retries
- Comprehensive Monitoring: Track performance, costs, and results across all workflow executions
┌─────────────────┐ ┌──────────────────┐
│ │ │ │
│ Web Client │◄───────►│ API Gateway │
│ │ │ │
└─────────────────┘ └──────────┬───────┘
│
▼
┌──────────────────────────────────────────────────────────┐
│ │
│ ┌─────────────┐ ┌───────────────┐ ┌──────────────┐ │
│ │ Workflow │ │ Workflow │ │ Execution │ │
│ │ Service │◄──► Manager │◄──► Service │ │
│ │ │ │ │ │ │ │
│ └─────────────┘ └───────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌───────────────┐ ┌───────────────┐ │
│ │ Orchestration │ │ Service │ │
│ │ Service │ │ Connectors │ │
│ └───────────────┘ └───────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────┐
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌──────────┐ │
│ │ Claude │ │ OpenAI │ │ Stability │ │
│ │ Service │ │ Service │ │ Service │ │
│ └─────────────┘ └─────────────┘ └──────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ ElevenLabs │ │ Custom │ │
│ │ Service │ │ Services │ │
│ └─────────────┘ └─────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘
Bonsai Tree's architecture follows a modular, microservices approach:
- API Gateway: Central entry point for all client requests
- Workflow Service: Manages workflow definitions and templates
- Workflow Manager: Coordinates workflow execution and task states
- Execution Service: Processes tasks with appropriate AI services
- Orchestration Service: Claude-powered reasoning for workflow optimization
- Service Connectors: Standardized interfaces to various AI providers
- Node.js v18+
- Docker and Docker Compose
- Supabase project
- Clone the repository
git clone https://github.com/your-org/bonsai-tree.git
cd bonsai-tree- Environment configuration
cp .env.example .env
# Edit .env with your Supabase credentials and API keys- Install dependencies
npm install- Start all services
# Using Docker Compose (recommended)
docker-compose up -d
# Without Docker (for development)
npm run dev- Verify installation
# Check the execution service
curl http://localhost:3001/health
# Check the web application
open http://localhost:3000Manages workflow definitions, including task sequences, dependencies, and inputs.
Orchestrates workflow executions, handles task states, and coordinates between services.
Runs individual tasks through appropriate service connectors with error handling.
Claude-powered reasoning system for intelligent workflow planning and optimization.
Standardized interfaces to AI providers with authentication, rate limiting, and error recovery:
- Anthropic Connector: Integrates with Claude models
- OpenAI Connector: Supports text and image generation
- Stability AI Connector: Provides image generation
- ElevenLabs Connector: Offers text-to-speech conversion
bonsai-tree/
├── apps/
│ └── web/ # Next.js frontend application
├── packages/
│ ├── core/ # Shared utilities and interfaces
│ ├── monitoring/ # Logging and metrics tools
│ ├── service-connectors/ # AI service integrations
│ ├── orchestration-engine/ # Claude-powered decision making
│ ├── execution-engine/ # Task execution framework
│ └── prompt-engineering/ # Prompt template management
├── services/
│ ├── api-gateway/ # API routing and authentication
│ ├── workflow-service/ # Workflow definition management
│ ├── workflow-manager/ # Workflow execution coordination
│ ├── execution-service/ # Task execution processing
│ ├── orchestration-service/ # AI-powered planning
│ └── analytics-service/ # Metrics and monitoring
└── docker/ # Containerization configurations
npm run dev: Start all services in development modenpm run build: Build all packages and servicesnpm run lint: Run ESLint across the codebasenpm run test: Run Jest testsnpm run docker:up: Start all services using Docker Composenpm run docker:down: Stop all Docker Compose services
Bonsai Tree includes a comprehensive analytics system that tracks:
- Execution Metrics: Performance data for workflows and tasks
- Service Metrics: Usage patterns across different AI providers
- Cost Estimation: Approximate costs based on token usage
- Usage Reporting: Insights into platform usage by users and services
Built on Supabase Auth, providing:
- User Management: Registration, login, and account management
- API Key Management: Programmatic access to the platform
- Role-Based Access Control: Admin, Developer, and Viewer roles
- JWT Token Authentication: Secure web application access
- API Key Authentication: Server-to-server integrations
For more detailed documentation:
- Setup Guide: Detailed installation instructions
- Deployment Guide: Production deployment process
- API Reference: API endpoint documentation
- Development Guide: Contributor guidelines
Contributions are welcome! Please see our Contributing Guide for details.
This project is licensed under the MIT License - see the LICENSE file for details.