A floating, always-on-top desktop chat app powered by Google Gemini AI and n8n automation. Stay productive with a modern AI assistant that understands text and voice, handles automation, and looks good while doing it.
- Install Node.js 16+ (Download)
- Clone the repository:
git clone https://github.com/Rakesh-ada/Deep.git cd Deep - Install dependencies and launch:
The app will:
npm install npm start
- Install required dependencies
- Check and install n8n (if not already present)
- Start n8n in the background
- Launch the floating AI chat interface
- Integrated n8n: App auto-starts n8n and connects, or uses your running n8n instance.
- Dual AI Engine: Switches between n8n (automation) and Google Gemini (natural language) for best results.
- No manual n8n setup required!
- Always-on-top, resizable, and minimizable
- Modern, animated UI
- Message history with one-click copy
- n8n AI: Automation and custom workflows
- Google Gemini AI: Natural language understanding (fallback)
- Smart Switching: Automatic failover and status lights (🔵 n8n, 🟣 Gemini)
- Google Speech-to-Text for voice input
- Text-to-Speech with male/female voices
- Visual mic controls and auto-timeout
- Launch the app and click the gear icon (⚙️) to open settings.
- Enter your n8n Webhook URL (optional, for custom workflows).
- The app will use Gemini AI if n8n is unavailable.
- Cross-platform: Windows, macOS, Linux
- Build installer or portable executable (
npm run build)
- Real-time logs, modular code, IPC
- Auto repair for dependencies
- No telemetry or tracking
- Local voice fallback
- Visual network indicators
To use all features of Deep AI Chat, you'll need to obtain the following API keys:
- Visit the Google AI Studio and sign in with your Google account
- Navigate to the API keys section (usually found in settings or dashboard)
- Create a new API key and copy it
- For more details, visit the Google AI documentation
- Create an account at ElevenLabs
- Navigate to your profile settings
- Find your API key in the "API" section
- Copy your API key
- Free tier includes limited usage; paid plans offer more voice options and usage
- Launch Deep AI Chat
- Click the gear icon (⚙️) in the top-right corner to open settings
- Paste your Google Gemini API key in the "Gemini API Key" field
- Paste your ElevenLabs API key in the "ElevenLabs API Key" field
- Click "Save Settings"
- The app will immediately begin using your API keys for enhanced functionality
Note: If you don't provide API keys, some features may be limited or unavailable. The app will attempt to use default services where possible.
- Open your terminal in this project directory.
- Run the following commands:
npm install npm start
- The application will launch.
- Node.js 16+
- npm (bundled with Node.js)
git clone https://github.com/Rakesh-ada/Deep.git
cd Deep
npm install
npm startnode install-electron.js # Downloads Electron (~250MB)
node install-dependencies.js # Installs other dependencies
npm startnpm run buildCreates an installer and a portable executable in the dist/ folder.
| Problem | Solution |
|---|---|
| n8n not connecting | Check if webhook URL is correct in settings |
| App won't start | Re-run node install-electron.js and install-dependencies.js |
| Voice not working | Ensure microphone permissions are enabled |
| Build fails | Delete dist/ and try npm run build again |
| API features not working | Check that you've entered valid API keys in settings |
| Rate limit errors | You may have exceeded your API quota; consider upgrading your plan |
- Electron (UI framework)
- n8n (workflow automation)
- Google Gemini (Generative AI)
- Google Cloud Speech API (voice recognition)
- ElevenLabs (Text-to-Speech)
- SQLite3 (local storage)
Built with ❤️ using n8n and Google AI.
We thank the n8n team and community for their outstanding work in workflow automation!
