Gemini Nexus

🚀 Gateway de IA multi-contas profissional para Google Gemini & Claude

--- ## 📖 Sumário - [Por que o Gemini Nexus?](#-por-que-o-gemini-nexus) - [Funcionalidades](#-funcionalidades) - [Screenshots](#-screenshots) - [Início Rápido](#-início-rápido) - [Stack Tecnológica](#️-stack-tecnológica) - [Desenvolvimento](#-desenvolvimento) - [FAQ](#-faq) - [Contribuindo](#-contribuindo) - [Licença](#-licença) --- ## ✨ Por que o Gemini Nexus? Ao usar IDEs e ferramentas de programação com IA, você já enfrentou estes problemas? - 😫 A cota da conta única acaba rápido, exigindo trocas manuais frequentes - 🔄 Gerenciar múltiplas contas do Google/Claude é cansativo - 📊 Não sabe quantos tokens já consumiu ou quanta cota resta - 🔌 Precisa de um proxy local confiável que fale os protocolos OpenAI/Anthropic - 🔍 Não consegue ver o que está sendo enviado/recebido pelo proxy **Gemini Nexus** resolve tudo isso. É um aplicativo desktop profissional em Electron que funciona como um gateway inteligente entre suas ferramentas de desenvolvimento e o Google Gemini / Claude AI: - ✅ **Pool de Contas Ilimitado** — Adicione quantas contas Google Gemini & Claude quiser - ✅ **Troca Automática Inteligente** — Rotaciona automaticamente para a próxima conta disponível quando a cota está baixa ou com rate limit - ✅ **Analytics de Uso em Tempo Real** — Dashboard nível SaaS com gráficos de área, indicadores de tendência e distribuição por modelo - ✅ **Observabilidade Completa do Proxy** — Monitor de tráfego ao vivo, replay de requisições e inspetor de capacidades dos modelos - ✅ **Compatível com OpenAI & Anthropic** — Proxy drop-in para Cursor, Windsurf, OpenCode e qualquer ferramenta compatível com OpenAI - ✅ **Seguro por Padrão** — Criptografia AES-256-GCM com gerenciamento nativo de credenciais do SO --- ## 🎯 Funcionalidades

☁️ Pool de Contas na Nuvem

Adicione contas ilimitadas do Google Gemini / Claude via OAuth
Exibe avatar, e-mail, status e último uso
Monitoramento de status em tempo real (Ativa, Rate Limited, Expirada)
Configuração de proxy URL por conta
Gerenciamento de perfil de identidade do dispositivo com histórico

📊 Dashboard de Analytics de Uso

Consumo de tokens em tempo real com auto-refresh a cada 15s
Gráficos de área para tokens de prompt & completion (diário/horário)
Indicadores de tendência (% de variação vs período anterior)
Sparklines inline nos cards de estatísticas
Ranking de distribuição por modelo com gráficos de barras horizontais
Visualização da proporção Prompt/Completion

🔌 Proxy de API Local (Gateway)

Endpoint compatível com OpenAI /v1/chat/completions
Endpoint compatível com Anthropic /v1/messages
Streaming SSE completo (testado com Cursor, Windsurf, OpenCode)
Mapeamento de modelos (ex: claude-sonnet-4-6 → gemini-3-flash)
Porta, timeout e API key configuráveis
Controle de visibilidade de modelos (mostrar/ocultar modelos específicos)

🔄 Troca Automática Inteligente

Modo de pool ilimitado com seleção inteligente de backup
Troca automática quando cota < 5% ou com rate limit
Monitoramento em segundo plano a cada 5 minutos
Fallback gracioso com rastreamento de motivo do status

🔍 Observabilidade do Proxy (Avançado)

Monitor de Tráfego — Log ao vivo de requisições/respostas com latência, status e informações do modelo
Replay de Requisições — Reproduza qualquer requisição registrada para debugging
Capacidades dos Modelos — Inspecione suporte a visão, thinking, streaming e modo JSON por modelo
Ferramentas para Devs — Geração de código cURL & Python, cópia com um clique

🔐 Segurança e Criptografia

Criptografia AES-256-GCM para todos os dados sensíveis
Integração com gerenciador de credenciais nativo do SO (Keytar + SafeStorage)
Migração automática de dados legados em texto plano
Armazenamento criptografado de tokens & cotas por conta

⚙️ Configurações e Personalização

Suporte a temas Escuro / Claro / Sistema
Multi-idioma: English & Português (Brasil)
Override de proxy URL por conta
Toggles de visibilidade de modelos
Acesso ao diretório de logs

🖥️ Experiência Desktop

App nativo Electron com integração na bandeja do sistema
Sidebar retrátil com estado persistente
Layouts responsivos em todas as telas
Barra de status com indicadores ao vivo de proxy e conexão
Error boundaries com fallbacks amigáveis ao usuário

--- ## 📸 Screenshots

Main

Usage

Proxy

Routing

Docs

Connections

Config

--- ## ⚡ Início Rápido ### Pré-requisitos - **Node.js** v20 ou superior - **npm** (este projeto usa `package-lock.json`) ### Compilando pelo Código Fonte ```bash # Clone o repositório git clone https://github.com/evandrodevbr/GeminiNexus.git cd GeminiNexus # Instale as dependências npm install # Inicie o modo de desenvolvimento npm start # Compile para produção (instalador Windows) npm run make ``` ### Usando com IDEs de IA Com o proxy em execução, configure sua IDE: ```plaintext # Nas configurações do Cursor / Windsurf / OpenCode: API Base URL: http://localhost:10100/v1 API Key: (copie da página Proxy no app) Model: gemini-3-flash (ou qualquer modelo mapeado) ``` --- ## 🛠️ Stack Tecnológica | Categoria | Tecnologias | |-----------|------------| | **Core** | [Electron](https://www.electronjs.org/), [React 19](https://react.dev/), [TypeScript](https://www.typescriptlang.org/) | | **Build** | [Vite](https://vitejs.dev/), [Electron Forge](https://www.electronforge.io/) | | **Estilização** | [Tailwind CSS v4](https://tailwindcss.com/), [Radix UI](https://www.radix-ui.com/), [Lucide Icons](https://lucide.dev/) | | **Estado** | [TanStack Query](https://tanstack.com/query/latest), [TanStack Router](https://tanstack.com/router/latest) | | **Backend** | [NestJS](https://nestjs.com/) (gateway interno), [ORPC](https://orpc.unnoq.com/) (RPC type-safe) | | **Banco de Dados** | [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3), [Drizzle ORM](https://orm.drizzle.team/) | | **Gráficos** | [Nivo](https://nivo.rocks/) (Line, Bar, Pie) | | **i18n** | [react-i18next](https://react.i18next.com/) | | **Testes** | [Vitest](https://vitest.dev/), [Playwright](https://playwright.dev/) | --- ## 💻 Desenvolvimento ```bash # Iniciar ambiente de dev (Electron + Vite HMR) npm start # Executar linting npm run lint # Verificar tipos npm run type-check # Formatar código npm run format:write # Rodar testes npm test ``` ### Estrutura do Projeto ```plaintext src/ ├── actions/ # Ações do app e orquestração de fluxos ├── components/ # Componentes React │ ├── proxy/ # Componentes da página Proxy (abas avançadas) │ ├── usage/ # Componentes de analytics de uso (StatCard, ChartCard) │ └── ui/ # Primitivos base de UI (baseados no Radix) ├── hooks/ # Custom React hooks ├── ipc/ # Electron IPC + handlers de banco de dados ├── layouts/ # Componentes de layout (MainLayout + sidebar) ├── localization/ # Recursos de tradução i18n ├── routes/ # Páginas TanStack Router (index, usage, proxy, settings) ├── server/ # Backend NestJS (serviço de gateway proxy) ├── services/ # Camada de serviços ├── types/ # Definições de tipos TypeScript + schemas Zod └── utils/ # Funções utilitárias ``` --- ## ❓ FAQ

P: O app não inicia?

1. Certifique-se de que todas as dependências estão instaladas: `npm install` 2. Verifique se a versão do Node.js é >= 20 3. Tente deletar `node_modules` e reinstalar 4. No Windows, certifique-se de que o WiX Toolset está disponível para `npm run make`

P: O login da conta falhou?

1. Verifique se a conexão com a internet está funcionando 2. Tente limpar os dados do app e fazer login novamente 3. Verifique se a conta está restrita pelo Google/Claude

P: A IDE não conecta no proxy?

1. Certifique-se de que o proxy está rodando (indicador verde na barra de status) 2. Verifique se a porta corresponde à configuração da sua IDE (padrão: `10100`) 3. Copie a API key da página Proxy e cole nas configurações da sua IDE 4. Verifique se pelo menos uma conta está ativa na página de Contas

P: A contagem de tokens mostra zero?

1. Este era um bug conhecido em versões anteriores — atualize para a versão mais recente 2. O rastreamento de tokens agora lida corretamente com metadados de streaming e contagens estimadas 3. Os dados de uso são atualizados a cada 15 segundos na página de Analytics de Uso

--- ## 🤝 Contribuindo Contribuições são bem-vindas! Leia o `CONTRIBUTING.md` para mais detalhes. --- ## 📄 Licença [CC BY-NC-SA 4.0](LICENSE) --- ## ⚠️ Aviso Legal > [!WARNING] > **Apenas para Fins Educacionais** > > Este projeto destina-se exclusivamente a fins de pesquisa e educação. Ele é fornecido "como está" sem qualquer garantia. **O uso comercial é estritamente proibido.** > > Ao usar este software, você concorda que não o utilizará para quaisquer fins comerciais, e que é o único responsável por garantir que seu uso esteja em conformidade com todas as leis e regulamentações aplicáveis. Os autores e contribuidores não se responsabilizam por qualquer uso indevido ou danos decorrentes do uso deste software. --- ## 🙏 Créditos **Gemini Nexus** é uma versão significativamente aprimorada e expandida do projeto original [AntigravityManager](https://github.com/Draculabo/AntigravityManager) criado por [Draculabo](https://github.com/Draculabo). Toda a arquitetura fundamental e design foram criados pelo autor original.