Gemini Nexus

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

English | Português (Brasil)

---

📖 Table of Contents

• Why Gemini Nexus?
• Improvements over Base Project
• Features
• Screenshots
• Quick Start
• Tech Stack
• Development
• Debugging Docs
• FAQ
• Contributing
• License

---

✨ Why Gemini Nexus?

When using your favorite IDEs, have you ever encountered these problems?

• 😫 Single account quota runs out quickly, requiring frequent manual switching
• 🔄 Managing multiple Google/Claude accounts is cumbersome
• 📊 Don't know how much quota is left on the current account
• ⏰ Worried about missing quota reset times
• 🔌 Need a reliable local API proxy for development tools

Gemini Nexus is here to solve these problems! It's a professional Electron desktop app that helps you:

• ✅ Unlimited Account Pool - Add any number of Google Gemini / Claude accounts
• ✅ Smart Auto-Switching - Automatically switch to the next available account when quota is low or rate-limited
• ✅ Real-time Monitoring - Visualize quota usage for all accounts
• ✅ Local API Proxy - Built-in OpenAI/Anthropic compatible proxy server
• ✅ Secure Encryption - AES-256-GCM encryption for sensitive data

---

🌟 Improvements over Base Project

This project contains significant development improvements, bug fixes, and configuration enhancements compared to the original base project.

Key improvements include:

• Enhanced API Management UI: Implemented dynamic model selectors and "Copy API Name" features to streamline integration with other tools.
• Robust SSE Streaming: Fixed critical Server-Sent Events (SSE) streaming bugs in the /v1/chat/completions proxy endpoint to perfectly support IDEs like Cursor, OpenCode, and Windsurf.
• Rebranding and Localization: Complete rebranding to Gemini Nexus with improved Portuguese (Brazil) localization and English defaults.
• Agentic Capabilities: Integration of advanced AI developer agents and skill frameworks (GSD, AutoResearch, Superpowers) directly into the project ecosystem for rapid autonomous development.
• Build & Dev Env: Better cross-platform build configurations, updated schemas, and automated toolchain processes.

---

🎯 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)	📊 Real-time Quota Monitoring Multi-model support: gemini-pro, claude-3-5-sonnet, etc. Visual progress bars with color indicators Auto & manual refresh capabilities
🔄 Intelligent Auto-Switching Unlimited pool mode with smart backup selection Auto-switch when quota < 5% or rate-limited Background monitoring every 5 minutes	🔐 Security First AES-256-GCM encryption for sensitive data OS native credential manager integration Auto migration of legacy plaintext data
🔌 Local API Proxy OpenAI & Anthropic API compatible Configurable port and request timeout Model mapping (e.g. Claude → Gemini)	🛠️ Developer Tools Built-in cURL & Python code generation Visual service status monitoring One-click API Key regeneration

---

📸 Screenshots

---

⚡ Quick Start

Build from Source

Prerequisites

• Node.js v18 or higher
• npm or pnpm

Steps

# Clone the repository
git clone https://github.com/Draculabo/GeminiNexus.git
cd GeminiNexus

# Install dependencies
npm install

# Start development
npm start

# Build for production
npm run make

---

🛠️ Tech Stack

Category	Technologies
Core	Electron, React, TypeScript
Build Tool	Vite
Styling	TailwindCSS, Shadcn UI
State	TanStack Query
Database	Better-SQLite3

---

❓ FAQ

Q: The app won't start?

Please check:

1. Make sure all dependencies are installed: npm install
2. Check if Node.js version is >= 18
3. Try deleting node_modules and reinstalling

Q: Account login failed?

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

---

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details.

---

📄 License

CC BY-NC-SA 4.0

---

⚠️ Disclaimer

Warning

For Educational Purposes Only

This project is intended solely for educational and research purposes. It is provided "as-is" without any warranty. Commercial use is strictly prohibited.

By using this software, you agree that you will not use it for any commercial purposes, and you are solely responsible for ensuring your use complies with all applicable laws and regulations. The authors and contributors are not responsible for any misuse or damages arising from the use of this software.

---

🙏 Credits

Gemini Nexus is a significantly enhanced and expanded version of the original project AntigravityManager created by Draculabo. All fundamental architecture and design were made by the original author.