ADA Turbo — Agency OS & Pixel Office

ADA Turbo — Agency OS & Pixel Office

---

🎬 Vista Previa de Oficina en Vivo y Animación

🏢 Visualizador de Oficina Pixel	🧪 Área de Pruebas de Flujo de Trabajo CRT

---

⚡ Inicio Rápido (Ejecutar en 10 Segundos)

Opción A: Sin Instalación con uvx (Recomendado)

Puedes ejecutar ADA Turbo al instante sin clonar ni gestionar entornos virtuales:

uvx ada-turbo-ai-mcp

(O lanza solo el visualizador web: uvx ada-turbo-ai-mcp --web)

---

Opción B: Git / Python Estándar

# 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

Abre http://localhost:8000 (con respaldo automático a 8001, 8002... si está ocupado) en tu navegador.

---

🚀 Características Clave

• Arquitectura Unificada de Doble Modo:
  • Modo MCP (Predeterminado): Se ejecuta como servidor stdio de MCP. Inicia simultáneamente el Servidor Web de Oficina Pixel en segundo plano. Se conecta sin problemas a Antigravity, Claude Desktop, Cursor, Claude Code y Windsurf.
  • Modo Web de Oficina Pixel: Inicia un espacio de trabajo web local con efecto CRT retro altamente optimizado (python server.py --web).
• ⚡ Transmisión de Eventos del Servidor (SSE) en Tiempo Real:
  • Transmisión de eventos de latencia cero (/api/events). Cuando se activa un agente en tu IDE, el personaje correspondiente camina visualmente hasta su escritorio en tiempo real.
• 🧠 Motor LLM en Vivo Directo:
  • Ejecución de IA multiproveedor directamente en el navegador mediante /api/llm-generate:
    • 🟢 Motor de Plantillas Integrado (Sin conexión): Acceso instantáneo a plantillas profesionales de flujo de trabajo de agencia sin claves API.
    • ✨ 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
  • Almacenamiento seguro de credenciales locales en el navegador localStorage.
• Herramientas de Desarrollo (Modales de Consola CRT):
  • Área de Pruebas (Probador de Flujo de Trabajo y IA en Vivo): Selecciona comandos y prueba tareas con plantillas sin conexión o modelos LLM en vivo con salida de máquina de escribir.
  • Configurador de Modelos de IA: Cambia de proveedor, ingresa claves API de forma segura y selecciona ajustes preestablecidos de modelos.
  • Asistente de Configuración: Genera dinámicamente bloques de configuración listos para copiar para Cursor, Antigravity, Claude Desktop y Claude Code.
• Personajes y Animaciones Pixel: 26 personajes únicos de agencia con ciclos de inactividad (respiración, parpadeo) y de caminata por pisos de oficina personalizados.
• Soporte Bilingüe Completo (TR / EN): Alternancia con un clic para todos los elementos de interfaz, insignias de estado, modales, indicaciones de agentes y referencias de conocimiento.

---

🔌 Integración con IDE (MCP)

1. Antigravity

Agrega a tu mcp_config.json:

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

2. Cursor

Agrega a ~/.cursor/mcp.json (global) o .cursor/mcp.json (a nivel de proyecto):

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

3. Claude Desktop

Agrega a tu 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

(Nota: Si usas un clon local, reemplaza "command": "uvx" y "args": ["ada-turbo-ai-mcp"] con "command": "python" y "args": ["/ABSOLUTE/PATH/server.py"])

---

👥 26 Roles y Especializaciones de Agencia

ADA Turbo organiza 26 agentes especializados en 5 departamentos clave:

1. Estrategia y Marca: Director de Marca, Estratega de Marca, Líder de Perspectiva del Consumidor, Especialista en Naming, Tecnólogo Creativo.
2. Creatividad y Diseño: Director Creativo, Redactor Senior, Director de Arte, Líder de UX/UI, Diseñador 3D/Movimiento.
3. Marketing y Crecimiento: Director de Marketing de Crecimiento, Especialista en Marketing de Rendimiento, Estratega de SEO/Contenido, Líder de Redes Sociales, Gerente de CRM y Retención.
4. Cliente y Operaciones: Director de Cuentas, Gerente de Cuentas Senior, Productor de Agencia, Director de Operaciones, Gerente de Tráfico.
5. Analítica y Tecnología: Director de Datos, Analista de Datos de Marketing, Líder Full-Stack, Arquitecto de Soluciones de IA, Líder de QA y Entrega.

---

📂 Arquitectura

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

---

📄 Licencia

Distribuido bajo la Licencia PolyForm Noncommercial 1.0.0. Consulta LICENSE para más detalles.

Desarrollado con ❤️ por ADA Creative Co.