Skip to content

monodox/compound-agent

Compound Agent

A self-improving automation engine that builds, monitors, and optimizes workflows autonomously using AI-powered intelligence. Built for the Raindrop Hackathon, Compound Agent leverages cutting-edge AI services and cloud infrastructure to create an intelligent operations platform.

πŸ”— Live Demo | πŸ“š GitHub Repository

Compound Agent Next.js TypeScript Tailwind CSS Raindrop Vultr

πŸš€ Features

Core Automation

  • AI Operations Engineer: 24/7 monitoring and optimization powered by Cerebras AI
  • Auto-Optimization: Continuous performance improvements with LiquidMetal workflows
  • Smart Analytics: Real-time insights and bottleneck detection
  • Safe Deployment: Automated testing and rollback mechanisms
  • Voice Alerts: ElevenLabs-powered audio notifications for critical events

Infrastructure Integration

  • Vultr Compute: Dedicated worker VMs for workflow execution and testing
  • Raindrop Platform: Complete MCP integration with SmartSQL, SmartBuckets, SmartMemory, and SmartInference
  • Multi-Cloud Support: Seamless integration across cloud providers

AI-Powered Intelligence

  • Cerebras AI: Ultra-fast inference for workflow optimization and anomaly detection
  • LiquidMetal: Advanced workflow orchestration and automation
  • ElevenLabs: Natural voice synthesis for alerts and notifications
  • Smart Context: Persistent AI memory for continuous learning

πŸ› οΈ Tech Stack

Frontend

  • Framework: Next.js 14 with App Router
  • Language: TypeScript 5
  • Styling: Tailwind CSS + shadcn/ui components
  • Icons: Lucide React
  • Animations: Framer Motion
  • State Management: React hooks + Context API

AI & ML Services

  • Cerebras: Ultra-fast AI inference for optimization and analysis
  • LiquidMetal: Workflow orchestration and automation engine
  • ElevenLabs: Voice synthesis for alerts and notifications

Infrastructure & Backend

  • Vultr Compute: Dedicated worker VMs for execution
  • Raindrop Platform: Complete MCP integration
    • SmartSQL: Workflow definitions and metrics storage
    • SmartBuckets: Version control and snapshots
    • SmartMemory: Persistent AI context and reasoning
    • SmartInference: AI-powered optimization generation
  • Authentication: WorkOS integration ready
  • Deployment: Vercel with global CDN

πŸ“¦ Installation

  1. Clone the repository

    git clone https://github.com/your-username/compound-agent.git
    cd compound-agent
  2. Install dependencies

    npm install
  3. Run the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:3000

πŸ—οΈ Project Structure

src/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ auth/                 # Authentication pages
β”‚   β”‚   β”œβ”€β”€ login/
β”‚   β”‚   β”œβ”€β”€ signup/
β”‚   β”‚   β”œβ”€β”€ forgot-password/
β”‚   β”‚   └── reset-password/
β”‚   β”œβ”€β”€ console/              # Main application
β”‚   β”‚   β”œβ”€β”€ dashboard/
β”‚   β”‚   β”œβ”€β”€ workflows/
β”‚   β”‚   β”œβ”€β”€ analytics/
β”‚   β”‚   β”œβ”€β”€ infrastructure/
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ legal/               # Legal pages
β”‚   β”œβ”€β”€ globals.css
β”‚   β”œβ”€β”€ layout.tsx
β”‚   └── page.tsx
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ ui/                  # shadcn/ui components
β”‚   β”œβ”€β”€ console-layout.tsx
β”‚   β”œβ”€β”€ console-header.tsx
β”‚   β”œβ”€β”€ console-sidebar.tsx
β”‚   └── ...
└── lib/
    └── utils.ts

🎨 Design System

Colors

  • Primary: Compound Indigo (#4F46E5 / indigo-600)
  • Background: Animated gradients with indigo, purple, and blue tones
  • Text: Slate color palette for optimal readability

Components

  • Built with shadcn/ui for consistency
  • Custom animations with Framer Motion
  • Responsive design with Tailwind CSS

🚦 Getting Started

Development

npm run dev     # Start development server
npm run build   # Build for production
npm run start   # Start production server
npm run lint    # Run ESLint

Environment Setup

Create a .env.local file by copying from the example:

cp .env.example .env.local

Then fill in your actual API keys and configuration values. See .env.example for all required variables.

πŸ”§ Configuration

Infrastructure Integration

  • Vultr: Configure API keys in Admin settings
  • Raindrop: Set up SmartSQL, SmartBuckets, SmartMemory, and SmartInference
  • WorkOS: Authentication and organization management

Workflow Templates

  • Data Processing (ETL pipelines)
  • API Integration (REST workflows)
  • Database Sync (Data synchronization)
  • Custom workflows from scratch

🌐 External Services

Raindrop Platform Services

  • SmartSQL: Intelligent database query optimization and management
  • SmartBuckets: Scalable object storage with AI-powered data organization
  • SmartMemory: High-performance caching and in-memory data processing
  • SmartInference: AI model serving and inference optimization

Vultr Platform Services

  • Compute Instances: Scalable virtual machines for workflow execution
  • Kubernetes Engine: Container orchestration for microservices
  • Object Storage: Reliable file and data storage
  • Load Balancers: Traffic distribution and high availability
  • Database: Managed PostgreSQL and MySQL instances

Additional External Services

  • WorkOS: Enterprise-grade authentication and user management
    • Why chosen: Provides SSO, directory sync, and compliance features essential for enterprise adoption
  • Vercel: Frontend hosting and deployment platform
    • Why chosen: Seamless Next.js integration with global CDN and automatic deployments
  • Framer Motion: Animation library for React
    • Why chosen: Provides smooth, performant animations that enhance user experience
  • Lucide React: Icon library
    • Why chosen: Consistent, customizable SVG icons with excellent React integration
  • shadcn/ui: Component library
    • Why chosen: Modern, accessible components built on Radix UI with Tailwind CSS styling

πŸ“Š Features Overview

Console Dashboard

  • Real-time system health monitoring
  • Workflow success rates and metrics
  • Recent activity and improvements

Workflow Management

  • Visual workflow builder
  • Template library
  • Version control and rollback
  • Automated testing

Analytics & Monitoring

  • Performance metrics and trends
  • Bottleneck detection
  • Success rate analysis
  • Real-time alerts

Infrastructure Management

  • Vultr worker console
  • Raindrop integration dashboard
  • Resource usage monitoring
  • Job history and logs

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

πŸ“„ License

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

πŸ†˜ Support

πŸ—ΊοΈ Roadmap

  • Advanced workflow templates
  • Multi-cloud infrastructure support
  • Enhanced AI capabilities
  • Mobile application
  • API marketplace integration

πŸ™ Acknowledgments


Built with ❀️ by the Compound Agent team

About

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors