XaresAICoder

A professional browser-based AI-powered development environment that integrates VS Code (code-server) with multiple AI coding assistants for enhanced productivity.

Overview

xaresaicoder.mp4

XaresAICoder provides isolated development workspaces running VS Code in the browser, with integrated AI coding tools for comprehensive development assistance. Each workspace runs in a separate Docker container with resource limits, automatic cleanup, and seamless subdomain-based port forwarding.

✨ Key Features

🎯 Professional Development Environment

• VS Code in Browser with light theme inspired design
• Isolated Docker Workspaces with automatic resource management
• Configurable Memory Allocation - Choose 1GB, 2GB, 4GB, 8GB, or 16GB RAM per workspace
• CPU Cores Selection - Allocate 1-8 CPU cores per workspace
• GPU Acceleration Support - Automatic GPU passthrough for ML/AI workloads
• Subdomain Port Forwarding (e.g., projectid-5000.localhost)
• Real-time Container Management with start/stop controls
• Optional Password Protection for workspace security

🤖 AI Development Tools

Pre-configured workspace with multiple AI coding assistants:

• Continue - VS Code extension for AI-powered code completion and chat
• Cline (Claude Dev) - AI coding assistant with file editing capabilities
• OpenCode SST - Multi-model AI assistant for project analysis
• Aider - AI pair programming with direct file editing and git integration
• Gemini CLI - Google's AI for code generation and debugging
• Claude Code - Anthropic's agentic tool for deep codebase understanding
• Qwen Code - AI workflow automation and code exploration
• OpenAI Codex CLI - OpenAI's terminal-based coding assistant

🔧 Development Ready

• Multiple Project Templates: Python Flask, Node.js React, Java Spring Boot, Empty Project
• Integrated Git Server (optional) - Self-hosted Forgejo with GitHub Actions compatibility
• Automatic Git Repository Creation - One-click Git repo setup with workspace configuration
• GitHub Integration - Pre-installed GitHub CLI for seamless workflow

🚀 Quick Start

Prerequisites

• Docker (with Docker Compose v1 or v2)
• 4GB+ RAM available for containers
• Modern web browser (Chrome/Chromium recommended)
• Optional: NVIDIA GPU with drivers for AI/ML acceleration

One-Command Installation

# Clone and deploy in one go
git clone <repository-url>
cd XaresAICoder
./deploy.sh

That's it! The deploy script automatically:

• ✅ Detects Docker Compose version (v1 or v2)
• ✅ Sets up persistent Docker network
• ✅ Builds custom VS Code image with AI tools
• ✅ Configures environment settings
• ✅ Deploys and health-checks the application

Access Your Platform

After deployment completes, open your browser to:

• Default: http://localhost
• Custom domain: Your configured domain from the deploy script

Create Your First Project

1. Enter a project name
2. Select your preferred project type:
   • Empty Project: Clean slate with just README and git initialization
   • Python Flask: Full-stack web applications with Flask framework
   • Node.js React: Modern web applications with React 18 and Vite
   • Java Spring Boot: Enterprise applications with Spring Boot 3.1
3. Choose memory allocation (1GB, 2GB default, 4GB, 8GB, or 16GB RAM) and CPU cores (1-8)
4. Optional: Check "Password Protect Workspace" for secure access
5. Optional: Check "Create Git Repository" to automatically set up Git
6. Click "Create Workspace"
7. VS Code opens in a new tab - start coding with AI assistance!

💡 GPU Support: If your host system has NVIDIA GPUs, they are automatically available in all workspaces for ML/AI development. Test with:

# Check GPU availability in workspace terminal
ls -la /dev/nvidia*
nvidia-smi  # if NVIDIA drivers are installed

AI Tools Setup

Once in your workspace, run this command to see setup instructions for all AI tools:

setup_ai_tools

📚 Documentation

For detailed information, see our comprehensive documentation:

• Installation Guide - Complete installation options and configuration
• Architecture Overview - Technical architecture and components
• Project Templates - Detailed template information and customization
• AI Development Tools - Complete guide to integrated AI assistants
• API Reference - API endpoints and usage examples
• Security Features - Security features and best practices
• Troubleshooting - Common issues and solutions
• Development Guide - Contributing and development setup

🔧 Deployment Options

# Full deployment (recommended for first-time setup)
./deploy.sh

# Deploy with integrated Git server (Forgejo)
./deploy.sh --git-server

# Skip image rebuild (faster for updates)  
./deploy.sh --skip-build

# See all options
./deploy.sh --help

🐳 Management Commands

# View logs
docker compose logs        # or docker-compose logs

# Stop services  
docker compose down        # or docker-compose down

# Restart services
docker compose restart     # or docker-compose restart

# Update deployment
git pull && ./deploy.sh --skip-network

🌐 Port Forwarding & Application Access

XaresAICoder uses subdomain-based routing for seamless application access:

• Flask/Python: http://projectid-5000.localhost/
• React/Node.js: http://projectid-3000.localhost/
• Spring Boot: http://projectid-8080.localhost/

VS Code automatically detects ports and provides one-click browser access.

🔐 Security

• Optional Password Protection: Secure individual workspaces with passwords
• Container Isolation: Each workspace runs in isolated Docker containers
• Resource Limits: CPU and memory limits prevent resource exhaustion
• Network Isolation: Workspaces can't access each other

🗂️ Integrated Git Server (Optional)

Deploy with self-hosted Git server for complete on-premise development:

# Deploy with Git server
./deploy.sh --git-server

# Access Git web interface
# http://localhost/git/
# Login: developer / admin123!

Features:

• GitHub Actions Compatible - Run existing CI/CD workflows
• Automatic Repository Creation - One-click Git integration during workspace creation
• Complete On-Premise Solution - No external dependencies

🚧 Current Status

✅ Production Ready

• Professional VS Code interface with AI tools
• Multiple project templates with best practices
• Container management with real-time monitoring
• Optional password protection and Git integration

🔮 Future Enhancements

• Multi-user authentication system
• Additional language templates (Go, Rust, PHP)
• Cloud deployment pipeline
• Team collaboration features

🤝 Contributing

We welcome contributions! See our Development Guide for details on:

• Setting up development environment
• Code contribution guidelines
• Architecture overview for developers

📄 License

This project is licensed under the MIT License.

• ✅ Completely free for personal, educational, and commercial use
• ✅ No restrictions on modification or distribution
• ✅ Open source and permissive licensing

See the LICENSE file for full details.

🆘 Support

• Quick Help: Check Troubleshooting Guide
• User Guide: See complete documentation
• Issues: Report bugs via GitHub issues
• API Health: http://localhost/api/health (when running)

---

🚀 Ready to enhance your development workflow with AI? Run ./deploy.sh and start coding!