Argon Framework

by devtno

Unlock Gemini 4 Argon Pro directly inside Google Antigravity and AI IDEs — with Deep Reasoning (Tarefas Complexas - Máx. Muito Detalhado) without paying Vertex AI Cloud token bills.

O Argon Framework é a ponte autônoma de alta fidelidade desenvolvida por devtno que conecta sua assinatura pessoal do Google One AI Premium / Google Gemini Pro diretamente ao Google Antigravity IDE (e a qualquer cliente compatível com MCP).

Com ele, o modelo mais poderoso do ecossistema Google — o Gemini 4 Argon (Tarefas Complexas - Raciocínio Máx. Muito Detalhado) — assume o comando do seu ambiente de desenvolvimento como agente primário para resolução de arquiteturas, análise de repositórios, escrita de código e engenharia reversa.

🎯 Por Que o Argon Framework Existe

O Paradoxo da Cobrança de IA para Desenvolvedores

1. Você já paga a Assinatura Pro: Milhões de desenvolvedores assinam o plano Google One AI Premium / Gemini Pro ($20/mês), que inclui acesso web ilimitado ao modelo Gemini 4 Argon com o modo de raciocínio máximo ativado no gemini.google.com.

2. O Bloqueio nas IDEs: As ferramentas de código (Google Antigravity, Cursor, etc.) conectam-se à API Cloud corporativa (Vertex AI / Google AI Studio), onde modelos da classe Argon exigem faturamento em dólares por milhão de tokens ou possuem cotas restritas.

3. A Solução devtno: O Argon Framework elimina essa barreira. Ele utiliza um motor Chromium persistente de alta fidelidade para executar prompts na sua sessão Google Pro oficial, delegando o raciocínio profundo ao 4 Argon Máx. e devolvendo o resultado à sua IDE em tempo real.

Os 3 Pilares do Framework

• 🛡️ Zero Cópia Manual de Cookies: Sem necessidade de abrir DevTools (F12) ou colar __Secure-1PSID. O motor gerencia a sessão de forma persistente e auto-sincronizada.

• 💾 100% de Persistência no Gemini Web: Toda conversa e código gerado no Antigravity é automaticamente salvo no histórico da sua conta no gemini.google.com/app, com links diretos clicáveis na IDE.

• 📊 Auditoria e Rastreabilidade Contínua: 100% dos prompts, respostas, latências e diagnósticos de software são gravados em arquivos .jsonl estruturados para conformidade e bug tracking.

Related MCP server: mcp_qwen

🏗️ Arquitetura do Sistema

flowchart TD
    subgraph Antigravity [" Google Antigravity IDE "]
        UserPrompt["Desenvolvedor / Prompt de Tarefa"]
        GlobalRule["Regra Global Obrigatória\ngemini_argon_default.md"]
        MCPClient["Cliente MCP Antigravity"]
        UserPrompt --> GlobalRule --> MCPClient
    end

    subgraph ArgonFramework [" Argon Framework Core (devtno) "]
        MCPServer["Servidor MCP Stdio\ngemini-4-argon-bridge"]
        ArgonClient["Argon Reasoning Client\nRoteamento & Latência"]
        AuditLogger["Audit Sentinel\nlogs/session_*.jsonl"]
        BrowserEngine["Motor de Navegador Persistente\nPlaywright Engine"]
        AuthManager["Session & Identity Guardian\nAuto-Sync ~/.gemini/"]

        MCPClient <==>|JSON-RPC 2.0| MCPServer
        MCPServer --> ArgonClient
        ArgonClient --> BrowserEngine
        ArgonClient -.-> AuditLogger
        BrowserEngine <--> AuthManager
    end

    subgraph GoogleWeb [" Google Cloud / Gemini Web Pro "]
        GeminiWebUI["gemini.google.com/app\nInterface Oficial"]
        ArgonModel["Gemini 4 Argon\nTarefas Complexas - Raciocínio Máx."]
        ChatHistory["Histórico de Conversas da Conta\nLinks Persistentes c_..."]

        BrowserEngine -->|Prompt & Modo Máx| GeminiWebUI
        GeminiWebUI --> ArgonModel
        ArgonModel --> GeminiWebUI
        GeminiWebUI --> ChatHistory
    end

    GeminiWebUI -->|Resposta + Link Web| BrowserEngine
    BrowserEngine --> ArgonClient --> MCPServer --> MCPClient

⚡ Instalação Rápida (1 Comando)

Pré-requisitos

• Sistema Operacional: Windows 10/11, macOS ou Linux.

• Python 3.9 ou superior.

• Google Antigravity IDE instalado.

• Conta Google com assinatura ativa do Google One AI Premium ou Google Gemini Pro.

Passo a Passo

🟢 Opção 1: No Windows (2 Cliques ou PowerShell)

git clone https://github.com/devtno/ARGON_FRAMEWORK.git
cd ARGON_FRAMEWORK
install.bat

(Ou no PowerShell: .\install.ps1)

🐧 Opção 2: No Linux ou macOS

git clone https://github.com/devtno/ARGON_FRAMEWORK.git
cd ARGON_FRAMEWORK
chmod +x install.sh && ./install.sh

🐍 Opção 3: Manualmente via Python

git clone https://github.com/devtno/ARGON_FRAMEWORK.git
cd ARGON_FRAMEWORK
pip install -r requirements.txt
playwright install chromium
python setup_global.py

O que o instalador faz automaticamente:

1. Abre a Janela de Autenticação Segura: Você faz login com 1 clique na sua Conta Google Pro. O framework salva a sessão permanentemente em ~/.gemini/browser_profile.

2. Registra o Servidor MCP: Configura o servidor gemini-argon em ~/.gemini/config/mcp_config.json.

3. Instala as Regras Globais: Injeta a diretriz permanente em ~/.gemini/config/rules/gemini_argon_default.md, garantindo que toda tarefa complexa no Antigravity seja processada pelo Argon.

4. Valida o Ambiente: Executa a suíte de testes de integridade.

🧩 O Ecossistema de Módulos e Agentes

Assim como os melhores frameworks de engenharia de software dividem responsabilidades com rigor, o Argon Framework é estruturado em agentes e módulos especializados:

🛠️ Catálogo de Ferramentas MCP Expostas

O servidor MCP registra nativamente as seguintes ferramentas dentro do Google Antigravity:

1. query_gemini_argon

Roteia e executa prompts no modelo Gemini 4 Argon (Tarefas Complexas - Máx. Muito Detalhado).

• Entrada: prompt (obrigatório), system_instruction (opcional), temperature (default: 0.7), max_output_tokens (opcional).

• Saída: Texto de raciocínio aprofundado, código gerado e o link direto da conversa salva no Gemini Web.

2. log_software_error

Registrador de defeitos e exceções de código com stack trace completo para Bug Tracking antes de propor correções.

• Entrada: error_message, stack_trace, context, tool_or_caller.

• Saída: Confirmação de gravação no log de auditoria com hash do evento.

3. get_session_audit_summary

Retorna métricas estatísticas da sessão atual (total de prompts disparados, latência média e resumo de chamadas).

• Entrada: recent_limit (quantidade de eventos recentes).

• Saída: JSON estruturado com métricas da sessão.

4. get_argon_auth_status

Diagnóstico em tempo real da saúde da sessão Google Pro e disponibilidade do motor Argon.

• Saída: Status de autenticação, caminho do perfil ativo e identificador da sessão.

🔬 Como Comprovar que Você Está no 4 Argon Máx. (As 4 Provas)

Muitos usuários se perguntam: "Se no rodapé do Antigravity diz Gemini 3.8 Flash, como provo que é o 4 Argon Máx. quem está respondendo?"

Existem 4 provas técnicas e físicas irrefutáveis:

1. O Link Direto na sua Conta do Gemini Web: Ao final de cada geração, o framework devolve o link da conversa (https://gemini.google.com/app/<id>). Abra o link no seu navegador: a conversa estará na sua conta Google pessoal com o selo Argon Máx. ^! O Flash 3.8 do Antigravity é isolado e não tem permissão de criar conversas na sua conta Google.

2. Árvore de Raciocínio Profundo (Deep Reasoning): O 4 Argon no modo Máx. pensa exaustivamente antes de responder, validando cenários de borda, complexidade de algoritmos e consistência formal. O Flash responde superficialmente sem essa árvore.

3. Latência de Processamento: O Flash 3.8 responde quase que instantaneamente (300ms–800ms). O 4 Argon com raciocínio Máx. leva entre 4 a 12 segundos processando o raciocínio denso antes de emitir a resposta completa.

4. Auditoria em Disco (logs/session_*.jsonl): Abra os arquivos de log na pasta logs/ do seu projeto. Cada resposta contém o carimbo formal:

   {
     "event_type": "model_response",
     "payload": {
       "model": "gemini-4-argon (Google Pro Web)",
       "account": "Google Pro (Alisson)",
       "latency_ms": 6840.5,
       "conversation_url": "https://gemini.google.com/app/c99f8ac051193f00"
     }
   }

🔒 Segurança, Imutabilidade e Privacidade

• Sem cobrança surpresa de API: O framework utiliza exclusivamente a assinatura pessoal já contratada pelo usuário.

• Isolamento de Credenciais: As credenciais ficam salvas localmente no diretório do usuário (~/.gemini/browser_profile). Nenhuma senha ou token é enviado para servidores de terceiros.

• Não-destrutivo: O framework não altera arquivos do seu projeto sem autorização. Ele atua como uma camada de inteligência e auditoria.

❓ Resolução de Problemas (FAQ)

O que fazer se o Google pedir login novamente?

Basta abrir o terminal e rodar:

python setup_global.py --login

A janela se abrirá por alguns segundos para você confirmar o acesso e o perfil será atualizado autonomamente.

Posso usar o framework em múltiplos projetos?

Sim. A instalação do Argon Framework é global. Uma vez executado o setup_global.py, qualquer workspace, repositório ou pasta aberta no Google Antigravity usará automaticamente o Gemini 4 Argon.

📜 Licença e Créditos

Desenvolvido com excelência por devtno.

Distribuído sob a licença MIT. Consulte o arquivo LICENSE para obter mais informações.

Copyright (c) 2026 devtno
All rights reserved.