Gemini Nexus Bot
afe8859f16
- Fix os module mock pattern for Vitest v4 in proxy-ide-config tests - Fix enterprise oauth_client_key expectations in cloudHandler-sync and token-manager-parity tests - Fix proxy-controller integration test argument expectations - Add missing proxy-parity JSON fixtures (OpenAI tools, Anthropic tool-use, Gemini SSE) - Add reasoning_content mapping to convertClaudeToOpenAIResponse - Fix google-api service test env var cache leak with resetModules + dynamic imports - Fix proxy-metrics timer tests by calling onModuleInit in beforeEach - Fix locale-sensitive number formatting in StatCard tests - Add missing test files to version control (components, hooks, ipc, mocks, server, utils) - Fix CI workflows: testing.yaml (use vitest run, add type-check job, npm cache), lint.yaml and format.yaml (add npm cache, concurrency, fix job names)
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/completionsproxy 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
|
📊 Real-time Quota Monitoring
|
🔄 Intelligent Auto-Switching
|
🔐 Security First
|
🔌 Local API Proxy
|
🛠️ Developer Tools
|
📸 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:
- Make sure all dependencies are installed:
npm install - Check if Node.js version is >= 18
- Try deleting
node_modulesand reinstalling
Q: Account login failed?
- Ensure network connection is working
- Try clearing app data and logging in again
- Check if the account is restricted by Google/Claude
🤝 Contributing
Contributions are welcome! Please read CONTRIBUTING.md for details.
📄 License
⚠️ 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.