🚀 Gateway de IA multi-cuenta profesional para Google Gemini y Claude
English | Português | 中文 | Español
Important
Usuarios de Windows: Si ves una advertencia de SmartScreen "Windows protegió su PC" durante la instalación, haz clic en "Más información" y luego en "Ejecutar de todas formas". Esta es una advertencia de seguridad esperada para aplicaciones nuevas no firmadas.
- ✨ ¿Por qué Gemini Nexus?
- 🎯 Características
- 📸 Capturas de Pantalla
- ⚡ Instalación e Inicio Rápido
- 🛠️ Stack Tecnológico
- 💻 Desarrollo
- ❓ Preguntas Frecuentes
- 🤝 Contribuir
- 📄 Licencia
Al usar IDEs y herramientas de programación con IA, ¿te has encontrado con estos problemas?
- 😫 Límites de cuota: La cuota de una sola cuenta se agota rápido, requiriendo cambios manuales frecuentes.
- 🔄 Gestión de cuentas: Gestionar múltiples cuentas de Google/Claude es tedioso.
- 📊 Uso a ciegas: No sabes cuántos tokens has consumido o cuánta cuota queda.
- 🔌 Problemas de integración: Necesitas un proxy local confiable que hable los protocolos OpenAI/Anthropic de forma nativa.
- 🔍 Falta de transparencia: No puedes ver qué se envía o recibe exactamente a través del proxy.
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 o hay rate limit.
- ✅ 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 con OpenAI.
- ✅ Seguro por Defecto — Cifrado AES-256-GCM con gestión nativa de credenciales del sistema operativo.
|
|
|
|
|
|
|
|
Puedes descargar los binarios precompilados más recientes para Windows, macOS y Linux desde nuestra página de Releases.
(Consulta la advertencia en la parte superior de esta página si usas Windows y te encuentras con el aviso de SmartScreen).
Con la aplicación en ejecución y al menos una cuenta agregada, configura tu IDE preferido (Cursor, Windsurf, OpenCode, etc.):
API Base URL: http://localhost:10100/v1
API Key: (copiar de la página Proxy en la app)
Model: gemini-3-flash (o cualquier modelo mapeado)
- Node.js v20 o superior
- npm (este proyecto usa
package-lock.json)
# Clonar el repositorio
git clone https://github.com/evandrodevbr/GeminiNexus.git
cd GeminiNexus
# Instalar dependencias
npm install
# Iniciar en modo desarrollo
npm start
# Compilar para producción (ej: instalador de Windows)
npm run make| 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 |
# Iniciar entorno de dev (Electron + Vite HMR)
npm start
# Ejecutar linting
npm run lint
# Verificación de tipos
npm run type-check
# Formatear código
npm run format:write
# Ejecutar pruebas
npm testP: ¿Aviso de Windows SmartScreen ("Windows protegió su PC") durante la instalación?
Sí, este es un aviso común para nuevas aplicaciones no firmadas. Haz clic en "Más información" y luego en "Ejecutar de todas formas". Consulta la advertencia en la parte superior del README para más detalles.
P: ¿La app no inicia al compilar desde el código fuente?
- Asegúrate de que todas las dependencias están instaladas:
npm install. - Verifica que tu versión de Node.js sea >= 20.
- Intenta eliminar
node_modulesy reinstalar. - En Windows, asegúrate de que el WiX Toolset esté disponible para el comando
npm run make.
P: ¿El inicio de sesión de la cuenta falló?
- Asegúrate de que tu conexión a la red funcione correctamente.
- Intenta borrar los datos de la app y volver a iniciar sesión.
- Comprueba si la cuenta está restringida por Google/Claude.
P: ¿El IDE no se puede conectar al proxy?
- Asegúrate de que el proxy esté funcionando (indicador verde en la barra de estado).
- Confirma que el puerto coincide con tu configuración del IDE (por defecto
10100). - Copia la API key directamente desde la página Proxy y pégala en la configuración de tu IDE.
- Asegúrate de tener al menos una cuenta activa en la página Cuentas.
¡Las contribuciones son bienvenidas! Por favor lee CONTRIBUTING.md para más detalles.
Este proyecto utiliza una estructura de licencia dual:
- Código original de AntigravityManager por Draculabo: Licenciado bajo CC BY-NC-SA 4.0.
- Todo el código nuevo, funcionalidades y arquitectura por evandrodevbr: Licenciado bajo la Licencia MIT.
🔄 Aviso de Migración: Este proyecto está siendo migrado activamente a una licencia completamente open-source (MIT). A medida que el código original restante se reescribe progresivamente, todo el proyecto hará la transición a MIT. Estamos comprometidos a hacer Gemini Nexus 100% open-source.
Este proyecto fue originalmente un fork de AntigravityManager creado por Draculabo. El concepto inicial del proxy y la estructura base de Electron se basaron en su trabajo.
Desde el fork, la gran mayoría del código ha sido reescrito, rediseñado y expandido por evandrodevbr, incluyendo pero no limitado a:
- Rediseño completo de UI/UX (navegación, cuentas, analíticas de uso, gestión del proxy)
- Dashboard de Analíticas de Uso con seguimiento de costos, promedios de tokens e integración con OpenRouter
- Monitor de tráfico con inspección de tokens/costos por solicitud
- Aislamiento de entorno (dev/prod), pipeline CI/CD e infraestructura de pruebas
- Configuración rápida para IDEs (OpenCode, Cursor, VS Code, Claude Code)
- Configuración personalizada de precios de modelos
- Toda la documentación e internacionalización (EN, PT-BR, ES, ZH-CN)