CodeAbyss – Free AI Cloud IDE & Online Compiler

Write, run, and deploy code in 8+ languages with an autonomous AI coding agent. 100% free. No signup required.

---

🎬 Demo

The full IDE — Monaco editor, terminal, AI agent, file explorer, live preview

✨ Key Highlights

Feature	Description
🧠 AI Coding Agent	Describe what you want → AI builds the full project
💻 8+ Languages	Python, JavaScript, TypeScript, C, C++, Java, Rust, HTML/CSS
🐳 Docker Sandbox	Isolated code execution with CPU/RAM limits
⚡ Zero Setup	Open the URL → start coding. No downloads, no signup
🎨 VS Code Editor	Monaco Editor with IntelliSense, syntax highlighting, themes
🖥️ Live Terminal	Full WebSocket terminal with xterm.js
👁️ Live Preview	Instant HTML/CSS/JS preview in embedded iframe
🔑 Bring Your Own Key	Use your own API keys for unlimited AI
🌙 Dark Neon UI	Beautiful animated interface with Framer Motion
📱 Responsive	Works on desktop, tablet, and mobile

---

🚀 Try It Now

Live: codeabyss.vercel.app

No signup. No credit card. Just open and code.

---

🛠️ Self-Host (5 minutes)

Prerequisites

• Node.js 22+
• Docker Desktop (optional, for sandbox)

Quick Start

git clone https://github.com/AbyssalCoder/CodeAbyss_AI_IDE.git
cd CodeAbyss_AI_IDE
npm install
cp .env.example .env
npm run dev

Service	URL
🌐 Web IDE	http://localhost:3000
⚙️ Node API	http://localhost:8787/health
🐍 Python API	http://localhost:8788/health

Docker (one command)

docker compose up

---

🤖 AI Configuration

CodeAbyss supports 3 AI providers. Auto mode cascades: Gemini → OpenRouter → Ollama.

Free AI (Zero Cost)

Provider	How to get key	Env variable
Gemini	aistudio.google.com	GEMINI_API_KEYS=your-key
OpenRouter	openrouter.ai	OPENROUTER_API_KEYS=key1,key2

Local AI (Fully Offline)

ollama pull qwen2.5-coder:7b
ollama serve

AI_PROVIDER=auto
OLLAMA_BASE_URL=http://127.0.0.1:11434

---

🏗️ Architecture

┌─────────────────────────────────────────────────┐
│                   Browser                        │
│  ┌──────────────────────────────────────────┐   │
│  │   Next.js 15 Frontend (Vercel)           │   │
│  │   Monaco Editor · xterm.js · Framer      │   │
│  └──────────────┬───────────────────────────┘   │
│                 │ REST + WebSocket               │
└─────────────────┼───────────────────────────────┘
                  │
┌─────────────────▼───────────────────────────────┐
│   Express API (Render – Docker)                  │
│   ┌──────────┐ ┌──────────┐ ┌────────────────┐ │
│   │ Postgres │ │ Terminal │ │ Code Execution │ │
│   │(Supabase)│ │   WS     │ │ (direct + safe)│ │
│   └──────────┘ └──────────┘ └────────────────┘ │
│   ┌──────────────────────────────────────────┐  │
│   │ AI Agent (Gemini / OpenRouter / Ollama)  │  │
│   └──────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘

---

� Code Execution

Supported languages: JavaScript, TypeScript, Python, C, C++, Java, Rust

• 🔒 Sanitized environment (no access to secrets/env vars)
• ⚡ Strict command allowlist + deny patterns
• ⏱️ 15-second execution timeout
• 📁 Per-project workspace isolation
• 🐳 Docker sandbox available locally (full isolation)
• 🏗️ Direct execution on deploy (compilers in container)

---

🔒 Security

• SQL injection protection (parameterized queries)
• Command injection prevention
• WebSocket terminal authentication
• Helmet.js security headers
• JWT auth with token blacklisting
• Rate limiting on all endpoints
• Sandbox network isolation

⚠️ Never commit real API keys. Use .env files only.

---

🌐 Free Deployment

Component	Platform	Cost
Frontend	Vercel	$0
Backend	Render	$0
Database	SQLite (embedded)	$0
AI	Gemini / OpenRouter free tiers	$0

Total monthly cost: $0

See docs/FREE_DEPLOYMENT.md for the full guide.

---

🗂️ Project Structure

apps/web/              → Next.js 15 frontend
  src/components/      → IDE, editor, terminal, agent panels
  src/lib/             → Config, utilities
services/api-node/     → Express API + SQLite
  src/                 → AI, auth, sandbox, terminal, workspace
services/api-python/   → FastAPI analysis service
demo-projects/         → Starter code for all 8 languages
docs/                  → Screenshots, deployment guide, marketing
scripts/               → Setup scripts, smoke tests

---

📊 Tech Stack

Layer	Technology
Frontend	Next.js 15, React 19, TypeScript, Tailwind CSS
Editor	Monaco Editor (VS Code engine)
Terminal	xterm.js + WebSocket
Backend	Express 4, Node.js 22
Database	PostgreSQL (Supabase)
AI	Google Gemini, OpenRouter, Ollama
Sandbox	Docker / Direct execution (Python, GCC, JDK, Rust)
Animation	Framer Motion
Auth	JWT + bcrypt
Deploy	Vercel + Render (free tier)

---

🤝 Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push (git push origin feature/amazing-feature)
5. Open a Pull Request

All PRs require review before merge (branch protection enabled).

---

⭐ Support

If CodeAbyss helps you, star the repo — it helps others find it!

---

📝 License

MIT — free for personal and commercial use.

---

Built with ❤️ by AbyssalCoder

🌐 codeabyss.vercel.app