gemini-nexus/README.es.md

Gemini Nexus

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

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

---

✨ ¿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

---

⚡ Inicio Rápido

Requisitos Previos

• Node.js v20 o superior
• npm

Compilar desde el Código Fuente

git clone https://github.com/evandrodevbr/GeminiNexus.git
cd GeminiNexus
npm install
npm start

# Compilar para producción
npm run make

Uso con IDEs de IA

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

---

⚠️ 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 creado por Draculabo. Toda la arquitectura fundamental y diseño fueron realizados por el autor original.