A comprehensive multi-purpose AI agent platform that combines Luna Agents for development lifecycle management with Nexa Backend for on-device AI inference. This platform enables intelligent automation across the entire software development lifecycle with advanced features including RAG integration, multi-platform app generation, and cloud-native deployment.
- Requirements Analysis Agent: Automatically analyze codebases and generate comprehensive requirements
- Design Architecture Agent: Create technical designs and architecture diagrams
- Code Review Agent: Perform automated code reviews with quality and security checks
- Testing Agent: Generate and execute comprehensive test suites
- Deployment Agent: Automate deployment processes with zero-downtime strategies
- Multi-Backend Support: CUDA, Metal, Vulkan, NPU, and CPU backends
- Model Format Compatibility: GGUF, MLX, and native .nexa format support
- OpenAI-Compatible API: Drop-in replacement for OpenAI API
- RAG Integration: Advanced context retrieval and token optimization
- Edge Computing: Cloudflare Workers deployment for global distribution
- OpenAI App Generator: Create ChatGPT applications from existing codebases
- Google Agent Generator: Build Google Assistant actions and voice interfaces
- React Native Generator: Generate cross-platform mobile apps with Expo
- Swift Native Generator: Create native iOS/iPadOS/macOS applications
- Apple HIG Compliance: Complete adherence to Apple Human Interface Guidelines
- Floating Components: Advanced floating panels and filter systems
- Accessibility: Full WCAG 2.1 AA compliance with VoiceOver support
- Dark/Light Mode: Automatic theme switching with system preferences
- Cloudflare Workers: Global edge deployment with automatic scaling
- Complete Migration: One-command migration to Cloudflare ecosystem
- Multi-Environment: Development, staging, and production environments
- Monitoring: Comprehensive observability with Prometheus and Grafana
- Node.js 20+ and pnpm 8+
- Docker and Docker Compose
- Git for version control
-
Clone the repository
git clone https://github.com/claude-agent/platform.git cd platform -
Install dependencies
pnpm install
-
Start development environment
# Start all services with Docker Compose pnpm run docker:up # Or start development servers pnpm run dev
-
Setup environment variables
cp .env.example .env # Edit .env with your API keys and configuration -
Run database migrations
pnpm run migrate pnpm run seed
- Web Application: http://localhost:3000
- API Server: http://localhost:3001
- Luna Agents: http://localhost:3002
- API Documentation: http://localhost:3001/docs
- Database Studio: http://localhost:5555
- RabbitMQ Management: http://localhost:15672
claude-agent-platform/
βββ packages/ # Core packages
β βββ api/ # NestJS API server
β βββ database/ # Prisma database schema
β βββ cache/ # Redis caching layer
β βββ monitoring/ # Observability and metrics
β βββ shared/ # Shared utilities and types
β βββ testing/ # Testing utilities
β βββ types/ # TypeScript type definitions
βββ apps/ # Applications
β βββ web/ # Next.js web application
β βββ cli/ # Command-line interface
β βββ deployment/ # Deployment tools
βββ tools/ # Development tools
β βββ cli/ # CLI tooling
β βββ web/ # Web-based tools
β βββ deployment/ # Deployment automation
βββ luna-agents/ # Luna agents ecosystem
β βββ .claude-plugin/ # Claude Code plugin
β βββ mcp-servers/ # MCP server implementations
β βββ agents/ # Individual agent implementations
βββ infrastructure/ # Infrastructure as code
βββ docs/ # Documentation
βββ tests/ # End-to-end and integration tests
pnpm run dev # Start all development services
pnpm run dev:api # Start API server only
pnpm run dev:agents # Start Luna agents only
pnpm run dev:web # Start web application onlypnpm run build # Build all packages and applications
pnpm run build:packages # Build packages only
pnpm run build:apps # Build applications only
pnpm run build:web # Build web application onlypnpm run test # Run all tests
pnpm run test:unit # Run unit tests
pnpm run test:integration # Run integration tests
pnpm run test:e2e # Run end-to-end tests
pnpm run test:coverage # Run tests with coveragepnpm run migrate # Run database migrations
pnpm run migrate:dev # Run migrations in development
pnpm run db:studio # Open Prisma Studio
pnpm run seed # Seed database with sample datapnpm run docker:up # Start all services with Docker
pnpm run docker:down # Stop all Docker services
pnpm run docker:logs # View Docker logspnpm run lint # Run ESLint
pnpm run lint:fix # Fix ESLint issues
pnpm run format # Format code with Prettier
pnpm run format:check # Check code formatting
pnpm run type-check # Run TypeScript type checkingCreate a .env file based on .env.example:
# Database
DATABASE_URL="postgresql://claude_user:claude_password@localhost:5432/claude_agent"
# Redis
REDIS_URL="redis://:redis_password@localhost:6379"
# Message Queue
RABBITMQ_URL="amqp://claude_user:claude_password@localhost:5672/claude_vhost"
# AI Services
OPENAI_API_KEY="your-openai-api-key"
ANTHROPIC_API_KEY="your-anthropic-api-key"
HUGGINGFACE_API_KEY="your-huggingface-api-key"
# JWT
JWT_SECRET="your-jwt-secret"
JWT_REFRESH_SECRET="your-jwt-refresh-secret"
# Application
NODE_ENV="development"
PORT="3001"
HOST="0.0.0.0"
# External Services
ELASTICSEARCH_URL="http://localhost:9200"
QDRANT_URL="http://localhost:6333"
MINIO_URL="http://localhost:9000"This project uses pnpm for package management with workspace configuration. The pnpm-workspace.yaml file includes a package catalog for consistent dependency management across all packages.
- Unit Tests: Jest-based unit tests for individual components
- Integration Tests: API and database integration testing
- End-to-End Tests: Playwright-based UI automation tests
- Performance Tests: Load testing and performance benchmarking
# Run all tests
pnpm run test
# Run specific test types
pnpm run test:unit
pnpm run test:integration
pnpm run test:e2e
# Run tests with coverage
pnpm run test:coverage
# Watch mode for development
pnpm run test:unit -- --watch- Minimum Coverage: 80% across all packages
- Critical Paths: 95% coverage for core functionality
- Integration Coverage: 90% for API endpoints
# Using Docker Compose
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d
# Or using pnpm scripts
pnpm run docker:up# Deploy to Cloudflare Workers
pnpm run deploy:production
# Or migrate entire infrastructure
pnpm run luna-cloudflare# Build for production
pnpm run build
# Start production server
pnpm run start- Development: Hot reload, debug logging, local services
- Staging: Production-like environment for testing
- Production: Optimized for performance and security
- API Health:
/api/healthendpoint - Database Health: Connection and query performance
- Cache Health: Redis connectivity and performance
- Message Queue Health: RabbitMQ status and queue depth
- Application Metrics: Request latency, error rates, throughput
- Infrastructure Metrics: CPU, memory, disk, network usage
- Business Metrics: User engagement, feature usage, conversion rates
- Structured Logging: JSON format with correlation IDs
- Log Levels: Debug, Info, Warn, Error, Fatal
- Log Aggregation: Centralized logging with Elasticsearch
- Log Retention: Configurable retention policies
- JWT Tokens: Access and refresh token rotation
- Multi-Factor Authentication: Optional 2FA support
- Role-Based Access Control: Granular permissions
- API Keys: For external integrations
- Encryption at Rest: AES-256 encryption
- Encryption in Transit: TLS 1.3
- Data Anonymization: PII protection and GDPR compliance
- Secure Storage: HashiCorp Vault integration
- Input Validation: Comprehensive input sanitization
- SQL Injection Prevention: Parameterized queries
- XSS Protection: Content Security Policy
- Rate Limiting: DDoS protection
- Security Headers: OWASP recommended headers
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- TypeScript: Strict mode with comprehensive type coverage
- ESLint: Enforced code quality and style rules
- Prettier: Consistent code formatting
- Husky: Pre-commit hooks for quality gates
- Conventional Commits: Standardized commit messages
- Tests: All tests must pass
- Coverage: Maintain 80%+ test coverage
- Documentation: Update relevant documentation
- Review: At least one maintainer approval required
- API Documentation: Complete API reference
- Architecture Guide: System architecture and design
- Agent Development: Building custom agents
- Deployment Guide: Production deployment
- Troubleshooting: Common issues and solutions
This project is licensed under the MIT License - see the LICENSE file for details.
- Claude: AI assistant for development assistance
- NestJS: Progressive Node.js framework
- Prisma: Next-generation ORM
- Cloudflare: Edge computing platform
- OpenAI: AI model provider
- Anthropic: AI research company
- GitHub Issues: Report bugs and request features
- Discussions: Community discussions and Q&A
- Documentation: Complete documentation
- Email: support@claude-agent.dev
- Core agent management system
- Basic task execution framework
- Multi-platform app generation
- Cloudflare Workers integration
- Apple HIG design system
- Advanced RAG integration
- Token optimization engine
- Enhanced monitoring dashboard
- Mobile app generators
- Google agent generator
- AI provider abstraction
- Advanced security features
- Performance optimization
- Multi-tenant support
- Advanced analytics
- Distributed agent network
- Advanced workflow automation
- Enterprise features
- Advanced AI capabilities
- Global marketplace
Built with β€οΈ by the Claude Agent Platform team# claude-agent