Gemini Nexus

🚀 Professional multi-account AI gateway for Google Gemini & Claude

> [!IMPORTANT] > **Windows Users:** If you see a **"Windows protected your PC"** (SmartScreen) warning during installation, click **"More info"** and then **"Run anyway"**. This is an expected security prompt for new, unsigned applications. --- ## 📖 Table of Contents - [✨ Why Gemini Nexus?](#-why-gemini-nexus) - [🎯 Features](#-features) - [📸 Screenshots](#-screenshots) - [⚡ Installation & Quick Start](#-installation--quick-start) - [🛠️ Tech Stack](#️-tech-stack) - [💻 Development](#-development) - [❓ FAQ](#-faq) - [🤝 Contributing](#-contributing) - [📄 License](#-license) --- ## ✨ Why Gemini Nexus? When using AI-powered IDEs and coding tools, have you ever run into these problems? - 😫 **Quota limits:** Single account quotas run out quickly, requiring frequent manual switching. - 🔄 **Account management:** Managing multiple Google/Claude accounts is cumbersome. - 📊 **Blind usage:** You don't know how much quota or how many tokens you've actually consumed. - 🔌 **Integration issues:** You need a reliable local API proxy that speaks OpenAI/Anthropic protocols natively. - 🔍 **Lack of transparency:** You can't see what's actually being sent or received by the proxy under the hood. **Gemini Nexus** solves all of these issues. It's a professional Electron desktop application that acts as an intelligent gateway between your development tools and Google Gemini / Claude AI. ### Key Value Proposition - ✅ **Unlimited Account Pool** — Add any number of Google Gemini & Claude accounts. - ✅ **Smart Auto-Switching** — Automatically rotates to the next available account when quota is low or rate-limited. - ✅ **Real-time Usage Analytics** — SaaS-grade dashboard with area charts, trend indicators, and model distribution. - ✅ **Full Proxy Observability** — Live traffic monitor, request replay, and model capabilities inspector. - ✅ **OpenAI & Anthropic Compatible** — Drop-in replacement proxy for Cursor, Windsurf, OpenCode, and any OpenAI-compatible tool. - ✅ **Secure by Default** — AES-256-GCM encryption with OS-native credential management. --- ## 🎯 Features

☁️ Cloud Account Pool

Add unlimited Google Gemini / Claude accounts via OAuth
Display avatar, email, status, and last used time
Real-time status monitoring (Active, Rate Limited, Expired)
Per-account proxy URL configuration
Device identity profile management with history

📊 Usage Analytics Dashboard

Real-time token consumption with 15s auto-refresh
Area charts for daily/hourly prompt & completion tokens
Trend indicators (% change vs previous period)
Inline sparklines on stat cards
Model distribution ranking with horizontal bar charts
Prompt/Completion ratio visualization

🔌 Local API Proxy (Gateway)

OpenAI /v1/chat/completions compatible endpoint
Anthropic /v1/messages compatible endpoint
Full SSE streaming support (tested with Cursor, Windsurf, OpenCode)
Model mapping (e.g. claude-sonnet-4-6 → gemini-3-flash)
Configurable port, timeout, and API key
Model visibility control (show/hide specific models)

🔄 Intelligent Auto-Switching

Unlimited pool mode with smart backup selection
Auto-switch when quota < 5% or rate-limited
Background monitoring every 5 minutes
Graceful fallback with status reason tracking

🔍 Proxy Observability (Advanced)

Traffic Monitor — Live request/response log with latency, status, and model info
Request Replay — Replay any recorded request for debugging
Model Capabilities — Inspect vision, thinking, streaming, JSON mode support per model
Developer Tools — cURL & Python code generation, one-click copy

🔐 Security & Encryption

AES-256-GCM encryption for all sensitive data
OS native credential manager integration (Keytar + SafeStorage)
Auto migration of legacy plaintext data
Encrypted token & quota storage per account

⚙️ Settings & Customization

Dark / Light / System theme support
Multi-language: English & Português (Brasil)
Per-account proxy URL override
Model visibility toggles
Log directory access

🖥️ Desktop Experience

Native Electron app with system tray integration
Collapsible sidebar with persistent state
Responsive layouts across all views
Status bar with live proxy and connection indicators
Error boundaries with user-friendly fallbacks

--- ## 📸 Screenshots

Main Dashboard

Usage Analytics

Proxy Monitor

Routing Config

Documentation

Active Connections

Settings Configuration

--- ## ⚡ Installation & Quick Start ### 📦 Download the App You can download the latest pre-compiled binaries for Windows, macOS, and Linux from our [Releases page](https://github.com/evandrodevbr/GeminiNexus/releases). *(Refer to the warning at the top of this page if you are using Windows and encounter the SmartScreen prompt).* ### 🔌 Using with AI IDEs Once the application is running and you have added at least one account, configure your preferred IDE (Cursor, Windsurf, OpenCode, etc.): ```plaintext API Base URL: http://localhost:10100/v1 API Key: (copy this from the Proxy page in the app) Model: gemini-3-flash (or any mapped model of your choice) ``` ### 🛠️ Build from Source #### Prerequisites - **Node.js** v20 or higher - **npm** (this project uses `package-lock.json`) #### Steps ```bash # Clone the repository git clone https://github.com/evandrodevbr/GeminiNexus.git cd GeminiNexus # Install dependencies npm install # Start the application in development mode npm start # Build for production (e.g., Windows installer) npm run make ``` --- ## 🛠️ Tech Stack | Category | Technologies | |----------|-------------| | **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/) | | **Styling** | [Tailwind CSS v4](https://tailwindcss.com/), [Radix UI](https://www.radix-ui.com/), [Lucide Icons](https://lucide.dev/) | | **State** | [TanStack Query](https://tanstack.com/query/latest), [TanStack Router](https://tanstack.com/router/latest) | | **Backend** | [NestJS](https://nestjs.com/) (internal gateway), [ORPC](https://orpc.unnoq.com/) (type-safe RPC) | | **Database** | [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3), [Drizzle ORM](https://orm.drizzle.team/) | | **Charts** | [Nivo](https://nivo.rocks/) (Line, Bar, Pie) | | **i18n** | [react-i18next](https://react.i18next.com/) | | **Testing** | [Vitest](https://vitest.dev/), [Playwright](https://playwright.dev/) | --- ## 💻 Development ```bash # Start dev environment (Electron + Vite HMR) npm start # Run linting npm run lint # Type check npm run type-check # Format code npm run format:write # Run tests npm test ``` ### Project Structure ```plaintext src/ ├── actions/ # App actions and flow orchestration ├── components/ # React UI components │ ├── proxy/ # Proxy page components (advanced tabs) │ ├── usage/ # Usage analytics components (StatCard, ChartCard) │ └── ui/ # Base UI primitives (Radix-based) ├── hooks/ # Custom React hooks ├── ipc/ # Electron IPC + database handlers ├── layouts/ # Layout components (MainLayout + sidebar) ├── localization/ # i18n translation resources ├── routes/ # TanStack Router pages (index, usage, proxy, settings) ├── server/ # NestJS backend (proxy gateway service) ├── services/ # Service layer ├── types/ # TypeScript type definitions + Zod schemas └── utils/ # Utility functions ``` --- ## ❓ FAQ

Q: "Windows protected your PC" (SmartScreen) warning during installation?

Yes, this is a common warning for new unsigned applications. Click **"More info"** and then **"Run anyway"**. See the warning at the top of the README for more details.

Q: The app won't start when building from source?

1. Make sure all dependencies are installed: `npm install` 2. Check if your Node.js version is >= 20. 3. Try deleting `node_modules` and reinstalling. 4. On Windows, ensure the WiX Toolset is available for `npm run make`.

Q: Account login failed?

1. Ensure your network connection is working. 2. Try clearing the app data and logging in again. 3. Check if the account is restricted by Google/Claude.

Q: My IDE can't connect to the proxy?

1. Make sure the proxy is actually running (look for the green indicator in the status bar). 2. Verify the port matches your IDE config (default is `10100`). 3. Copy the API key directly from the Proxy page and paste it into your IDE settings. 4. Check that at least one account is active in the Accounts page.

Q: Token counts are showing zero?

1. This was a known bug in earlier versions — please update to the latest release. 2. Token tracking now correctly handles streaming metadata and estimated counts. 3. Usage data refreshes every 15 seconds on the Usage Analytics page.

--- ## 🤝 Contributing Contributions are welcome! Please read `CONTRIBUTING.md` for details. --- ## 📄 License This project uses a dual-license structure: - **Original code** from [AntigravityManager](https://github.com/Draculabo/AntigravityManager) by [Draculabo](https://github.com/Draculabo): Licensed under [CC BY-NC-SA 4.0](LICENSE). - **All new code, features, and architecture** by [evandrodevbr](https://github.com/evandrodevbr): Licensed under the [MIT License](LICENSE-MIT). > 🔄 **Migration Notice:** This project is actively being migrated to a fully open-source license (MIT). As the remaining original code is progressively rewritten, the entire project will transition to MIT. We are committed to making Gemini Nexus 100% open-source. --- ## 🙏 Credits This project was originally forked from [AntigravityManager](https://github.com/Draculabo/AntigravityManager) created by [Draculabo](https://github.com/Draculabo). The initial proxy concept and early Electron scaffolding were based on his work. Since the fork, **the vast majority of the codebase has been rewritten, redesigned, and expanded** by [evandrodevbr](https://github.com/evandrodevbr), including but not limited to: - Complete UI/UX redesign (navigation, accounts, usage analytics, proxy management) - Usage Analytics dashboard with cost tracking, token averages, and OpenRouter integration - Traffic monitor with per-request token/cost inspection - Environment isolation (dev/prod), CI/CD pipeline, and test infrastructure - IDE Quick Setup (OpenCode, Cursor, VS Code, Claude Code) - Custom model pricing configuration - All documentation and internationalization (EN, PT-BR, ES, ZH-CN)