Gemini Nexus

Gemini Nexus

🚀 Gateway de IA multi-cuenta profesional para Google Gemini y Claude

English | Português | 中文 | Español

Versión Descargas Licencia Plataforma

--- ## ✨ ¿Por qué Gemini Nexus? Al usar IDEs y herramientas de programación con IA, ¿te has encontrado con estos problemas? - 😫 La cuota de una sola cuenta se agota rápido, requiriendo cambios manuales frecuentes - 🔄 Gestionar múltiples cuentas de Google/Claude es tedioso - 📊 No sabes cuántos tokens has consumido o cuánta cuota queda - 🔌 Necesitas un proxy local confiable que hable los protocolos OpenAI/Anthropic **Gemini Nexus** resuelve todo esto. Es una aplicación de escritorio profesional en Electron que actúa como gateway inteligente entre tus herramientas de desarrollo y Google Gemini / Claude AI: - ✅ **Pool de Cuentas Ilimitado** — Agrega cualquier cantidad de cuentas Google Gemini y Claude - ✅ **Cambio Automático Inteligente** — Rota automáticamente a la siguiente cuenta disponible cuando la cuota es baja - ✅ **Analytics de Uso en Tiempo Real** — Dashboard nivel SaaS con gráficos de área, indicadores de tendencia y distribución por modelo - ✅ **Observabilidad Completa del Proxy** — Monitor de tráfico en vivo, replay de solicitudes e inspector de capacidades de modelos - ✅ **Compatible con OpenAI y Anthropic** — Proxy drop-in para Cursor, Windsurf, OpenCode y cualquier herramienta compatible - ✅ **Seguro por Defecto** — Cifrado AES-256-GCM con gestión nativa de credenciales del SO --- ## 🎯 Características

☁️ Pool de Cuentas en la Nube

  • Agrega cuentas ilimitadas de Google Gemini / Claude vía OAuth
  • Muestra avatar, email, estado y último uso
  • Monitoreo de estado en tiempo real (Activa, Rate Limited, Expirada)
  • Configuración de proxy URL por cuenta
  • Gestión de perfil de identidad del dispositivo con historial

📊 Dashboard de Analytics de Uso

  • Consumo de tokens en tiempo real con auto-refresh cada 15s
  • Gráficos de área para tokens de prompt y completion (diario/horario)
  • Indicadores de tendencia (% de cambio vs período anterior)
  • Sparklines inline en las tarjetas de estadísticas
  • Ranking de distribución por modelo con gráficos de barras horizontales
  • Visualización de proporción Prompt/Completion

🔌 Proxy de API Local (Gateway)

  • Endpoint compatible con OpenAI /v1/chat/completions
  • Endpoint compatible con Anthropic /v1/messages
  • Soporte completo de streaming SSE
  • Mapeo de modelos (ej: claude-sonnet-4-6 → gemini-3-flash)
  • Puerto, timeout y API key configurables
  • Control de visibilidad de modelos

🔄 Cambio Automático Inteligente

  • Modo pool ilimitado con selección inteligente de respaldo
  • Cambio automático cuando cuota < 5% o con rate limit
  • Monitoreo en segundo plano cada 5 minutos
  • Fallback elegante con seguimiento de razón de estado

🔍 Observabilidad del Proxy (Avanzado)

  • Monitor de Tráfico — Log en vivo de solicitudes/respuestas
  • Replay de Solicitudes — Reproduce cualquier solicitud para debugging
  • Capacidades de Modelos — Inspecciona visión, thinking, streaming, modo JSON
  • Herramientas para Devs — Generación de código cURL y Python

🔐 Seguridad y Cifrado

  • Cifrado AES-256-GCM para todos los datos sensibles
  • Integración con gestor de credenciales nativo del SO
  • Migración automática de datos legacy en texto plano
  • Almacenamiento cifrado de tokens y cuotas por cuenta

⚙️ Configuración y Personalización

  • Tema Oscuro / Claro / Sistema
  • Multi-idioma: English & Português (Brasil)
  • Toggles de visibilidad de modelos
  • Acceso al directorio de logs

🖥️ Experiencia de Escritorio

  • App nativa Electron con integración en bandeja del sistema
  • Sidebar colapsable con estado persistente
  • Layouts responsivos
  • Barra de estado con indicadores en vivo
--- ## 📸 Capturas de Pantalla

Main

Usage

Proxy

Routing

Docs

Connections

Config

--- ## ⚡ Inicio Rápido ### Requisitos Previos - **Node.js** v20 o superior - **npm** ### Compilar desde el Código Fuente ```bash git clone https://github.com/Draculabo/GeminiNexus.git cd GeminiNexus npm install npm start # Compilar para producción npm run make ``` ### Uso con IDEs de IA ```plaintext API Base URL: http://localhost:10100/v1 API Key: (copiar de la página Proxy en la app) Model: gemini-3-flash ``` --- ## 🛠️ Stack Tecnológico | Categoría | Tecnologías | |-----------|------------| | **Core** | Electron, React 19, TypeScript | | **Build** | Vite, Electron Forge | | **Estilos** | Tailwind CSS v4, Radix UI, Lucide Icons | | **Estado** | TanStack Query, TanStack Router | | **Backend** | NestJS (gateway interno), ORPC (RPC type-safe) | | **Base de Datos** | Better-SQLite3, Drizzle ORM | | **Gráficos** | Nivo (Line, Bar, Pie) | | **Testing** | Vitest, Playwright | --- ## ❓ Preguntas Frecuentes
P: ¿La app no inicia? 1. Asegúrate de que las dependencias están instaladas: `npm install` 2. Node.js versión >= 20 3. Intenta eliminar `node_modules` y reinstalar
P: ¿El IDE no conecta al proxy? 1. Asegúrate de que el proxy está corriendo (indicador verde en la barra de estado) 2. Confirma que el puerto coincide (por defecto `10100`) 3. Copia la API key de la página Proxy 4. Asegúrate de tener al menos una cuenta activa
--- ## 📄 Licencia [CC BY-NC-SA 4.0](LICENSE) --- ## ⚠️ Aviso Legal > [!WARNING] > **Solo con Fines Educativos** > > Este proyecto está destinado exclusivamente a fines educativos y de investigación. Se proporciona "tal cual" sin ninguna garantía. **El uso comercial está estrictamente prohibido.** --- ## 🙏 Créditos **Gemini Nexus** es una versión significativamente mejorada y expandida del proyecto original [AntigravityManager](https://github.com/Draculabo/AntigravityManager) creado por [Draculabo](https://github.com/Draculabo). Toda la arquitectura fundamental y diseño fueron realizados por el autor original.