ADA Turbo — Agency OS & Pixel Office

ADA Turbo — Agency OS & Pixel Office

---

🎬 Prévia do Office ao Vivo e Animações

🏢 Pixel Office Visualizer	🧪 CRT Workflow Playground

---

⚡ Início Rápido (Execute em 10 Segundos)

Opção A: Zero-Instalação com uvx (Recomendado)

Você pode executar ADA Turbo instantaneamente sem clonar ou gerenciar ambientes virtuais:

uvx ada-turbo-ai-mcp

(Ou inicie apenas o visualizador web: uvx ada-turbo-ai-mcp --web)

---

Opção B: Git / Python Padrão

# 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

Abra http://localhost:8000 (fallback automático para 8001, 8002... se ocupado) no seu navegador.

---

🚀 Principais Recursos

• Arquitetura Unificada de Modo Duplo:
  • Modo MCP (Padrão): Executa como um servidor MCP stdio. Inicia simultaneamente o Pixel Office Web Server em segundo plano. Conecta-se perfeitamente a Antigravity, Claude Desktop, Cursor, Claude Code e Windsurf.
  • Modo Web Pixel Office: Inicia um workspace web local altamente otimizado com efeito retro CRT (python server.py --web).
• ⚡ Server-Sent Events (SSE) em Tempo Real:
  • Streaming de eventos com zero latência (/api/events). Quando um agente é acionado na sua IDE, o personagem correspondente caminha visualmente até sua mesa em tempo real!
• 🧠 Motor LLM Ao Vivo Direto:
  • Execução de IA multi-provedor diretamente no navegador via /api/llm-generate:
    • 🟢 Mecanismo de Template Integrado (Offline): Acesso instantâneo a templates profissionais de fluxo de trabalho de agência sem chaves de 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
  • Armazenamento seguro de credenciais locais no navegador localStorage.
• Ferramentas de Desenvolvedor (Modais de Console CRT):
  • Playground (Testador de Workflow e IA ao Vivo): Selecione comandos e teste tarefas com templates offline ou modelos LLM ao vivo com saída de máquina de escrever.
  • Configurador de Modelos de IA: Alterne provedores, insira chaves de API com segurança e selecione predefinições de modelos.
  • Assistente de Configuração: Gera dinamicamente blocos de configuração prontos para copiar para Cursor, Antigravity, Claude Desktop e Claude Code.
• Personagens Pixel e Animações: 26 personagens exclusivos de agência com ciclos de idle (respiração, piscar) e caminhada pelos andares personalizados do escritório.
• Suporte Bilíngue Completo (TR / EN): Alternância com um clique para todos os elementos de interface, badges de status, modais, prompts de agentes e referências de conhecimento.

---

🔌 Integração com IDE (MCP)

1. Antigravity

Adicione ao seu mcp_config.json:

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

2. Cursor

Adicione ao ~/.cursor/mcp.json (global) ou .cursor/mcp.json (nível de projeto):

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

3. Claude Desktop

Adicione ao seu 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: Se usar clone local, substitua "command": "uvx" e "args": ["ada-turbo-ai-mcp"] por "command": "python" e "args": ["/ABSOLUTE/PATH/server.py"])

---

👥 26 Papéis e Especializações de Agência

ADA Turbo organiza 26 agentes especializados em 5 departamentos-chave:

1. Estratégia e Marca: Diretor de Marca, Estrategista de Marca, Líder de Insights do Consumidor, Especialista em Naming, Tecnólogo Criativo.
2. Criativo e Design: Diretor Criativo, Redator Sênior, Diretor de Arte, Líder de UX/UI, Designer 3D/Motion.
3. Marketing e Crescimento: Diretor de Marketing de Crescimento, Especialista em Marketing de Performance, Estrategista de SEO/Conteúdo, Líder de Mídias Sociais, Gerente de CRM e Retenção.
4. Cliente e Operações: Diretor de Contas, Gerente Sênior de Contas, Produtor de Agência, Diretor de Operações, Gerente de Tráfego.
5. Analytics e Tecnologia: Chief Data Officer, Analista de Dados de Marketing, Líder Full-Stack, Arquiteto de Soluções de IA, Líder de QA e Entrega.

---

📂 Arquitetura

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

---

📄 Licença

Distribuído sob a Licença PolyForm Noncommercial 1.0.0. Consulte LICENSE para detalhes.

Desenvolvido com ❤️ por ADA Creative Co.