Gemini Nexus Bot
a3eabc2aaa
Route fixes: - Add POST /v1/messages/chat/completions alias so OpenCode clients misconfigured with baseURL ending in /v1/messages no longer get 404 Session affinity: - Extract x-session-affinity HTTP header (sent by OpenCode) and use it as the session key for token stickiness, falling back to body-level session_id fields if the header is absent Tool calling (streaming): - finish_reason is now 'tool_calls' when function calls were emitted in the stream (Gemini always sends STOP, so we check toolCallIndex > 0) - createSyntheticOpenAIStream (stream fallback path) now emits all tool_call deltas before the finish chunk instead of silently dropping them when content is null Tool calling (non-streaming): - content is now always null when tool_calls are present, satisfying strict clients that reject non-null content alongside tool_calls - system_fingerprint field added to OpenAIChatResponse interface and response builder for OpenAI spec compliance Usage accounting: - thoughtsTokenCount is now included in completion_tokens and total_tokens for the streaming usage chunk, fixing undercount for thinking/reasoning model runs
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.