GitHub - andybraren/platform: Virtual team management and collaboration platform

Ambient Code Platform

Kubernetes-native AI automation platform for intelligent agentic sessions with multi-agent collaboration

Overview

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.

Key Capabilities

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

🚀 Quick Start

Get running locally in under 2 minutes with Kind:

make kind-up
# Access at http://localhost:8080

Full guide: Kind Local Development

Alternative approaches: Minikube (older) • CRC (OpenShift-specific)

Architecture

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

📚 Documentation

For Users

📘 User Guide - Using the platform
🚀 Deployment Guide - Production deployment

For Developers

🔧 Contributing Guide - How to contribute
💻 Developer Guide - Development setup and standards
🏗️ Architecture - Technical design and ADRs
🧪 Testing - Test suite documentation

Local Development

⚡ 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

Integrations

🤖 Amber Automation Tool

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.

🧩 Components

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

🤝 Contributing

We welcome contributions! Please see:

CONTRIBUTING.md - Contribution guidelines
CLAUDE.md - Development standards for AI assistants
Code of Conduct

Quick Development Workflow

# 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-feature

📄 License

This 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.