ADA Turbo — Agency OS & Pixel Office

🎬 Live Office & Animation Preview

⚡ Quick Start (Run in 10 Seconds)

Option A: Zero-Install with `uvx` (Recommended)

You can run ADA Turbo instantly without cloning or managing virtual environments:

uvx ada-turbo-ai-mcp

*(Or launch just the web visualizer: `uvx ada-turbo-ai-mcp --web`)*

Option B: Standard Git / Python

# 1. Clone the repository
git clone https://github.com/adacreativeco/ada-turbo-ai-mcp.git
cd ada-turbo-ai-mcp

# 2. Install dependencies
pip install -r requirements.txt

# 3. Start Unified Dual-Mode (MCP stdio + Web Visualizer)
python server.py

Open http://localhost:8000 (auto-fallback to `8001`, `8002`... if occupied) in your browser.

🚀 Key Features

• Unified Dual-Mode Architecture:
  • MCP Mode (Default): Runs as an MCP stdio server. Concurrently starts the Pixel Office Web Server in the background. Seamlessly connects to Antigravity, Claude Desktop, Cursor, Claude Code, and Windsurf.
  • Pixel Office Web Mode: Starts a local, highly-optimized retro CRT-effect web workspace (`python server.py --web`).
• ⚡ Real-Time Server-Sent Events (SSE):
  • Zero-latency event streaming (`/api/events`). When an agent is triggered in your IDE, the corresponding character visually walks to their desk in real-time!
• 🧠 Direct Live LLM Engine:
  • Multi-provider AI execution directly in the browser via `/api/llm-generate`:
    • 🟢 Built-in Template Engine (Offline): Instant access to professional agency workflow templates without API keys.
    • ✨ Google Gemini: `gemini-2.0-flash`, `gemini-1.5-flash`, `gemini-1.5-pro`
    • 🧠 OpenAI: `gpt-4o-mini`, `gpt-4o`, `o3-mini`
    • ⚡ Anthropic Claude: `claude-3-5-sonnet-20241022`, `claude-3-5-haiku-20241022`
  • Safe local credential storage in browser `localStorage`.
• Developer Tools (CRT Console Modals):
  • Playground (Workflow & Live AI Tester): Select commands and test tasks with offline templates or live LLM models with typewriter output.
  • AI Model Configurator: Switch providers, enter API keys safely, and select model presets.
  • Setup Wizard: Dynamically outputs ready-to-copy configuration blocks for Cursor, Antigravity, Claude Desktop, and Claude Code.
• Pixel Characters & Animations: 26 unique agency characters with idle (breathing, blinking) and walking cycles across custom office floors.
• Full Bilingual Support (TR / EN): One-click toggle for all UI elements, status badges, modals, agent prompts, and knowledge references.

🔌 IDE Integration (MCP)

1. Antigravity

Add to your `mcp_config.json`:

{
  "mcpServers": {
    "ada-turbo": {
      "command": "uvx",
      "args": ["ada-turbo-ai-mcp"]
    }
  }
}

2. Cursor

Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-level):

{
  "mcpServers": {
    "ada-turbo": {
      "command": "uvx",
      "args": ["ada-turbo-ai-mcp"]
    }
  }
}

3. Claude Desktop

Add to your `claude_desktop_config.json`:

{
  "mcpServers": {
    "ada-turbo": {
      "command": "uvx",
      "args": ["ada-turbo-ai-mcp"]
    }
  }
}

4. Claude Code (CLI)

claude mcp add ada-turbo -- uvx ada-turbo-ai-mcp

*(Note: If using local clone, replace `"command": "uvx"` and `"args": ["ada-turbo-ai-mcp"]` with `"command": "python"` and `"args": ["/ABSOLUTE/PATH/server.py"]`)*

👥 26 Agency Roles & Specializations

ADA Turbo organizes 26 specialized agents across 5 key departments:

1. Strategy & Brand: Brand Director, Brand Strategist, Consumer Insight Lead, Naming Specialist, Creative Technologist.

2. Creative & Design: Creative Director, Senior Copywriter, Art Director, UX/UI Lead, 3D/Motion Designer.

3. Marketing & Growth: Growth Marketing Director, Performance Marketing Specialist, SEO/Content Strategist, Social Media Lead, CRM & Retention Manager.

4. Client & Operations: Account Director, Senior Account Manager, Agency Producer, Operations Director, Traffic Manager.

5. Analytics & Tech: Chief Data Officer, Marketing Data Analyst, Full-Stack Lead, AI Solutions Architect, QA & Delivery Lead.

📂 Architecture

ada-turbo-mcp/
├── server.py                   ← Unified dual-mode entry point (MCP + Web)
├── index.html                  ← Retro CRT Pixel Office single-page UI
├── pyproject.toml              ← Package metadata & entry points
├── smithery.yaml               ← Smithery.ai 1-click install configuration
├── requirements.txt            ← Project dependencies
├── references/                 ← Bilingual domain knowledge bases (.md)
│   ├── strategy-brand.md / strateji-marka.md
│   ├── creative-team.md / yaratici-ekip.md
│   ├── marketing-growth.md / pazarlama-buyume.md
│   ├── client-operations.md / musteri-operasyon.md
│   └── analytics-product-tech.md / analitik-urun-teknik.md
├── karakterler/                ← Pixel character graphics and generator scripts
├── animasyonlar/               ← Character walk/idle spritesheets & GIF previews
├── office-bina/ & office-zon/  ← Procedural pixel art building generation assets
├── skill/                      ← Pre-packaged .skill distribution bundle
└── src/                        ← Python modules
    ├── mcp_server.py           ← FastMCP server definitions & tool registrations
    ├── web_server.py           ← Multi-threaded HTTP server, SSE broadcaster & LLM proxy
    └── workflow_manager.py     ← Command routing, action listener dispatch & templates

📄 License

Distributed under the PolyForm Noncommercial License 1.0.0. See LICENSE for details.

Developed with ❤️ by **ADA Creative Co.**