Quick Start Docker Export AI Auto-Fix Config

⚡ The Difference

🐳 Docker Containers

Every Conversation Gets Its Own Isolated Container

📦 Pre-installed Tools

⚡ Container Features

🎛️ Resource Limits (Configurable)

🖥️ Built-in Web Terminal

root@container:~$ python --version
Python 3.11.9
root@container:~$ node --version
v18.19.0
root@container:~$ pip install pandas numpy matplotlib
Successfully installed pandas-2.2.0 numpy-1.26.4 matplotlib-3.8.3
root@container:~$ ls -la
total 16
drwxr-xr-x 1 root root 4096 Jan 15 10:30 .
-rw-r--r-- 1 root root 2048 Jan 15 10:30 script.py
-rw-r--r-- 1 root root 8192 Jan 15 10:30 data.csv

📦 Docker Image Export

How It Works

On Another Machine

# Load the exported image
docker load < my-project_2025年01月15日_143052.tar
# Run it
docker run -it my-project_2025年01月15日_143052:latest bash
# You're back in your exact environment!
root@container:/workspace$ ls
script.py data.csv results/

Features

Configuration

🤖 AI Providers

6 AI Providers - Choose Your Favorite (or Use Them All!)

🦙 Ollama Integration - Free Local AI

# Install Ollama (one command)
curl -fsSL https://ollama.ai/install.sh | sh # Linux
brew install ollama # macOS
# Pull models
ollama pull llama3 # General purpose (8B)
ollama pull llama3:70b # More powerful (70B)
ollama pull codellama # Optimized for code
ollama pull deepseek-coder # Code specialist
ollama pull mistral # Fast & efficient
# Models auto-detected in AI Code Executor!

💻 LM Studio Integration - GUI-Based Local AI

qwen2.5-coder-32b-instruct # Excellent for code (32B)
deepseek-coder-v2 # Fast code specialist
codellama-34b # Meta's code model

# Run as Administrator to allow remote connections
New-NetFirewallRule -DisplayName "LM Studio API" -Direction Inbound -LocalPort 1234 -Protocol TCP -Action Allow

🎤 Whisper Voice Integration

🔧 Auto-Fix System

Intelligent Error Detection & Automatic Repair

Example: Auto-Fix in Action

Auto-Fix Configuration

Custom Auto-Fix Prompt

The code execution failed with the following error:
{errors}
Analyze the error carefully and provide ONLY the fixed code.
Do not explain - just provide working code.
If dependencies are missing, install them first with pip/npm.

⚙️ Configuration

📝 Custom System Prompts

You are a professional coder who provides complete, executable code solutions. 
Present only code, no explanatory text. Present code blocks in execution order. 
If dependencies are needed, install them first using a bash script.

🔑 API Keys Configuration

🐳 Docker Resource Limits

Environment Variables (.env)

# ═══════════════════════════════════════════════════════════════════════════
# 🔑 API KEYS
# ═══════════════════════════════════════════════════════════════════════════
ANTHROPIC_API_KEY=sk-ant-... # Claude models
OPENAI_API_KEY=sk-... # GPT models
GEMINI_API_KEY=AIza... # Gemini models
# ═══════════════════════════════════════════════════════════════════════════
# 🦙 OLLAMA (Local AI)
# ═══════════════════════════════════════════════════════════════════════════
OLLAMA_HOST=http://localhost:11434 # Local or remote Ollama server
# ═══════════════════════════════════════════════════════════════════════════
# 💻 LM STUDIO (Local AI)
# ═══════════════════════════════════════════════════════════════════════════
LMSTUDIO_HOST=http://localhost:1234 # Local or remote LM Studio server
# ═══════════════════════════════════════════════════════════════════════════
# 🎤 WHISPER (Voice Input)
# ═══════════════════════════════════════════════════════════════════════════
WHISPER_SERVER_URL= # Remote Whisper GPU server (optional)
# ═══════════════════════════════════════════════════════════════════════════
# ⚡ EXECUTION SETTINGS
# ═══════════════════════════════════════════════════════════════════════════
DOCKER_EXECUTION_TIMEOUT=30 # Seconds (0 = unlimited)
AUTO_FIX_MAX_ATTEMPTS=10 # Retry attempts (1-20)
# ═══════════════════════════════════════════════════════════════════════════
# 🐳 DOCKER RESOURCE LIMITS
# ═══════════════════════════════════════════════════════════════════════════
DOCKER_CPU_CORES=2 # 1-16 cores
DOCKER_MEMORY_LIMIT=8g # 512m-32g RAM
DOCKER_STORAGE_LIMIT=10g # 1g-100g disk
DOCKER_EXPORT_PATH=./docker_images_exported # Where exported images are saved
# ═══════════════════════════════════════════════════════════════════════════
# 📝 PROMPTS (Customize AI behavior)
# ═══════════════════════════════════════════════════════════════════════════
SYSTEM_PROMPT=You are a professional coder...
AUTO_FIX_PROMPT=The code failed with:\n\n{errors}\n\nProvide fixed code only.
# ═══════════════════════════════════════════════════════════════════════════
# 🌐 SERVER
# ═══════════════════════════════════════════════════════════════════════════
HOST=0.0.0.0
PORT=8000

📁 File Management

Upload, Browse, Download - All In Browser

📱 Mobile Support

Fully Responsive - Works on Any Device

🚀 Quick Start

# Clone
git clone https://github.com/Ark0N/AI-Code-Executor.git
or
wget https://github.com/Ark0N/AI-Code-Executor/archive/refs/heads/main.zip
unzip main.zip
cd AI-Code-Executor
# Install (auto-detects OS & container runtime)
chmod +x INSTALL.sh && ./INSTALL.sh
# Start
./start.sh

🐳 Docker Deployment

Quick Docker Start

# Clone the repository
git clone https://github.com/Ark0N/AI-Code-Executor.git
cd AI-Code-Executor
# Create .env file with your API keys
cp .env.example .env
# Edit .env and add your API keys (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.)
# Start with Docker Compose
docker compose up -d
# View logs
docker compose logs -f
# Open http://localhost:8000

Docker Files Overview

How It Works

┌─────────────────────────────────────────────────────────────┐
│ Host Machine │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ AI Code Executor Container │ │
│ │ - FastAPI Backend │ │
│ │ - Web Frontend │ │
│ │ - Docker CLI (talks to host Docker) │ │
│ └───────────────────────────────────────────────────────┘ │
│ │ │
│ │ /var/run/docker.sock │
│ ▼ │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ Docker Daemon │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Sandbox #1 │ │ Sandbox #2 │ │ Sandbox #N │ │ │
│ │ │ (Conv. 1) │ │ (Conv. 2) │ │ (Conv. N) │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Environment Variables

# Required - At least one AI provider
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=AIza...
# Optional - Server settings
PORT=8000
# Optional - Docker resource limits for code execution
DOCKER_CPU_CORES=2
DOCKER_MEMORY_LIMIT=8g
DOCKER_STORAGE_LIMIT=10g
DOCKER_EXECUTION_TIMEOUT=30
# Optional - Ollama (if running on host)
OLLAMA_HOST=http://host.docker.internal:11434
# Optional - Remote Whisper server
WHISPER_SERVER_URL=

Docker Commands Reference

# Start in background
docker compose up -d
# Start with build (after code changes)
docker compose up -d --build
# View logs
docker compose logs -f
# View logs for specific service
docker compose logs -f ai-code-executor
# Stop containers
docker compose down
# Stop and remove volumes (deletes data!)
docker compose down -v
# Restart
docker compose restart
# Check status
docker compose ps
# Shell into running container
docker exec -it ai-code-executor bash
# Build sandbox image manually
docker build -t ai-code-executor:latest .
# Build app image manually 
docker build -f Dockerfile.app -t ai-code-executor-app:latest .

Connecting to Ollama (Local AI)

# Ollama is accessible at host.docker.internal automatically
OLLAMA_HOST=http://host.docker.internal:11434

# The docker-compose.yml includes extra_hosts for this
OLLAMA_HOST=http://host.docker.internal:11434
# Or use your machine's IP
OLLAMA_HOST=http://192.168.1.100:11434

Data Persistence

# Backup database
docker run --rm -v ai-executor-data:/data -v $(pwd):/backup alpine \
 tar cvf /backup/ai-executor-backup.tar /data
# Restore database
docker run --rm -v ai-executor-data:/data -v $(pwd):/backup alpine \
 tar xvf /backup/ai-executor-backup.tar -C /

Troubleshooting Docker

# On Linux, add your user to docker group
sudo usermod -aG docker $USER
newgrp docker
# Or run with sudo
sudo docker compose up -d

# Build manually
docker build -t ai-code-executor:latest .
# Check if image exists
docker images | grep ai-code-executor

# Verify Ollama is running
curl http://localhost:11434/api/tags
# Test from inside container
docker exec -it ai-code-executor curl http://host.docker.internal:11434/api/tags

# Change port in .env
PORT=8001
# Or stop conflicting service
sudo lsof -i :8000

📦 Installation

Supported Platforms

Container Runtimes

🍎 macOS

# Install Homebrew (if needed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Install Docker
brew install --cask docker # Docker Desktop
# OR
brew install colima docker && colima start # Colima (lightweight)

🐧 Linux

# Install Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker

🔒 Security

📁 Project Structure

AI-Code-Executor/
├── backend/
│ ├── main.py # FastAPI app, auto-fix logic, endpoints
│ ├── code_executor.py # Docker container management
│ ├── anthropic_client.py # Claude API integration
│ ├── openai_client.py # GPT API integration
│ ├── gemini_client.py # Gemini API integration
│ ├── ollama_client.py # Local Ollama integration
│ ├── lmstudio_client.py # Local LM Studio integration
│ ├── whisper_client.py # Local Whisper voice input
│ ├── whisper_remote.py # Remote Whisper GPU server
│ └── database.py # SQLite async ORM
│
├── frontend/
│ ├── index.html # Main UI
│ ├── app.js # Application logic
│ └── style.css # Styling
│
├── whisper/ # Standalone Whisper server
├── docs/ # Documentation
├── scripts/ # Utility scripts
│
├── Dockerfile # Sandbox container (code execution)
├── Dockerfile.app # Application container
├── docker-compose.yml # Docker Compose deployment
├── .dockerignore # Docker build exclusions
├── INSTALL.sh # Universal installer
├── start.sh # Start server
├── requirements.txt # Python dependencies
└── .env.example # Configuration template

🤝 Contributing

📝 License

If AI Code Executor saves you time, show some love!

GitHub stars GitHub forks

Made with ❤️ for developers who want AI that actually runs code

Coded with help of Claude AI (Sonnet 4.5 and Opus 4.5)

© 2025 AI Code Executor