Kubernetes-native AI automation platform for intelligent agentic sessions with multi-agent collaboration
The Ambient Code Platform is an AI automation platform that combines Claude Code CLI with multi-agent collaboration capabilities. The platform enables teams to create and manage intelligent agentic sessions through a modern web interface.
- Intelligent Agentic Sessions: AI-powered automation for analysis, research, content creation, and development tasks
- Multi-Agent Workflows: Specialized AI agents model realistic software team dynamics
- Git Provider Support: Native integration with GitHub and GitLab (SaaS and self-hosted)
- Kubernetes Native: Built with Custom Resources, Operators, and proper RBAC for enterprise deployment
- Real-time Monitoring: Live status updates and job execution tracking
Get running locally in under 2 minutes with Kind:
make kind-up
# Access at http://localhost:8080Full guide: Kind Local Development
Alternative approaches: Minikube (older) • CRC (OpenShift-specific)
The platform consists of containerized microservices orchestrated via Kubernetes:
| Component | Technology | Description |
|---|---|---|
| Frontend | NextJS + Shadcn | User interface for managing agentic sessions |
| Backend API | Go + Gin | REST API for managing Kubernetes Custom Resources |
| Agentic Operator | Go | Kubernetes operator that watches CRs and creates Jobs |
| Claude Code Runner | Python + Claude Code CLI | Pod that executes AI with multi-agent collaboration |
Learn more: Architecture Documentation
- 📘 User Guide - Using the platform
- 🚀 Deployment Guide - Production deployment
- 🔧 Contributing Guide - How to contribute
- 💻 Developer Guide - Development setup and standards
- 🏗️ Architecture - Technical design and ADRs
- 🧪 Testing - Test suite documentation
- ⚡ Kind Development - Recommended (fastest, used in CI/CD)
- 🔄 Local Development Options - Kind vs Minikube vs CRC
- 📦 Minikube Setup - Older approach (still supported)
- 🔴 CRC Setup - For OpenShift-specific features
Amber
- 🤖 Auto-Fix: Automated linting/formatting fixes
- 🔧 Refactoring: Automated code refactoring tasks
- 🧪 Test Coverage: Automated test generation
Quick Links:
Note: Amber is a development tool for this repository and does NOT need to be deployed with the platform.
Each component has its own detailed README:
- Frontend - Next.js web application
- Backend - Go REST API
- Operator - Kubernetes controller
- Runners - AI execution pods
- Manifests - Kubernetes deployment resources
We welcome contributions! Please see:
- CONTRIBUTING.md - Contribution guidelines
- CLAUDE.md - Development standards for AI assistants
- Code of Conduct
# Fork and clone
git clone https://github.com/YOUR_USERNAME/vTeam.git
cd vTeam
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes and test
make local-up
make test
# Submit PR
git push origin feature/amazing-featureThis project is licensed under the MIT License - see the LICENSE file for details.
Quick Links: Quick Start • User Guide • Architecture • Contributing • API Docs
Note: This project was formerly known as "vTeam". Technical artifacts (image names, namespaces, API groups) still use "vteam" for backward compatibility.