akupara/CLAUDE.md

AI container orchestration platform

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

Akupara is an AI container orchestration platform that enables running multiple AI coding assistants (Claude, GPT-4, Gemini, etc.) in containerized environments. The name comes from Hindu mythology - the cosmic turtle that supports the universe.

Current Status: **Initial Planning Phase** - Project structure is being set up according to AKUPARA_SETUP.md roadmap.

## Architecture

The project follows a multi-language architecture:
- **Core orchestration**: Python (in `src/akupara/`)
- **CLI interface**: JavaScript/Node.js (in `src/cli/`)
- **Containerization**: Docker for each AI model
- **AI Chambers**: Isolated configurations for each AI model (in `chambers/`)

Key architectural components:
- `src/akupara/core/`: Core orchestration logic
- `src/akupara/containers/`: Container management
- `src/akupara/orchestrator/`: AI model orchestration
- `chambers/`: AI-specific configurations (claude/, gpt4/, gemini/)

## Development Commands

Since the project is in initial setup, these commands will be available after setup:

### Python Development
```bash
# Install dependencies (once setup.py is configured)
pip install -e .

# Run tests (once pytest is configured)
pytest

# Build Python package
python -m build
```

### Node.js/CLI Development  
```bash
# Install dependencies (once package.json is properly configured)
npm install

# Run tests (once test framework is added)
npm test

# Build/publish npm package
npm publish
```

### Docker Commands
```bash
# Build containers (once Dockerfiles are created)
docker-compose build

# Run all services
docker-compose up

# Run specific AI chamber
docker-compose up claude
```

## Project Setup Tasks

Follow AKUPARA_SETUP.md for initial setup. Key steps:
1. Create GitHub repository using `gh repo create`
2. Reserve npm package name
3. Reserve PyPI package name  
4. Create Docker Hub repository
5. Register domain: akupara.ai
6. Set up initial project structure
7. Configure CI/CD pipeline

## Development Guidelines

- Each AI model runs in its own isolated container ("chamber")
- Use consistent naming: `akupara` for the platform, `chambers` for AI environments
- Follow the phased development roadmap in AKUPARA_SETUP.md
- Keep AI model integrations modular and extensible
- Prioritize container isolation and security

## Current Focus

The immediate priority is completing the initial setup checklist from AKUPARA_SETUP.md:
- Creating repositories across GitHub, npm, PyPI, and Docker Hub
- Setting up the basic project structure
- Creating initial placeholder packages to reserve the name