gemini-argon
by devtno
README.md
# Argon Framework
<small>by devtno</small>
**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.**
[](LICENSE)
[](https://www.python.org/downloads/)
[](https://modelcontextprotocol.io/)
[](https://antigravity.google)
[](https://gemini.google.com)
[](https://github.com/devtno)
---
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](https://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](https://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.
---
## 🏗️ Arquitetura do Sistema
```mermaid
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)
```cmd
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
```bash
git clone https://github.com/devtno/ARGON_FRAMEWORK.git
cd ARGON_FRAMEWORK
chmod +x install.sh && ./install.sh
```
#### 🐍 Opção 3: Manualmente via Python
```bash
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:
| Módulo / Agente | Papel | Responsabilidade Principal |
| :--- | :--- | :--- |
| **Argon MCP Server** | Gateway Stdio | Servidor JSON-RPC 2.0 em conformidade com o padrão MCP oficial, conectando o Antigravity à suite. |
| **Gemini Web Pro Bridge** | Motor de Execução | Automação resiliente via Playwright Chromium. Mantém cookies vivos, seleciona o modelo 4 Argon e salva no Gemini Web. |
| **Argon Reasoning Client** | Orquestrador | Gerencia requisições, cronometra latência com precisão de milissegundos e controla rotas de fallback. |
| **Audit Sentinel** | Telemetria & Logs | Grava 100% dos eventos em formato `JSONL` (`logs/session_*.jsonl`) com timestamp ISO-8601 para auditoria forense. |
| **Session & Identity Guardian** | Gestão de Acesso | Valida tokens da Conta Google, previne expiração de sessão e gerencia o perfil persistente. |
| **Antigravity Rule Enforcer** | Diretriz Global | Regra do sistema que instrui o assistente do Antigravity a delegar código e tarefas complexas ao Argon. |
---
## 🛠️ 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:
```json
{
"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:
```bash
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](LICENSE) para obter mais informações.
```
Copyright (c) 2026 devtno
All rights reserved.
```
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues