"A silent AI halo around your work: meetings, code, and research."

Horalix Halo is a powerful, beautiful desktop AI assistant built with cutting-edge technology. It combines multi-provider LLM support, intelligent mode switching, real-time meeting assistance, and a stunning glassmorphism UI into one seamless experience.

• 5 AI Providers: DeepSeek (primary), OpenAI, Anthropic (Claude), Google (Gemini), Ollama
• 15+ Models: GPT-4, Claude Sonnet 4, Gemini 2.0 Flash, DeepSeek V3, Llama 3.2, and more
• Real-time Streaming: SSE streaming with reasoning extraction
• Smart Caching: LRU cache with automatic fallback and cost tracking

• Auto Mode: AI automatically detects the best approach
• Coding Mode: Optimized for development (low temperature, best practices)
• Meeting Mode: Real-time transcription + 9 specialized quick actions
• Research Mode: Deep analysis with comprehensive responses

Choose exactly how the AI responds:

• Auto, Short, Detailed, Step-by-Step
• Code-Only, ELI5, Concise
• Conversational, Academic

9 specialized quick actions:

1. Quick Summary
2. Action Items extraction
3. Key Decisions highlight
4. Follow-up suggestions
5. Explain Technical concepts
6. Clarify Points
7. Counter-Arguments
8. Generate Response
9. Email Draft

• Glassmorphism Design: Beautiful iOS/macOS-inspired aesthetic
• Purple/Indigo/Teal Gradients: Professional brand identity
• Framer Motion Animations: Smooth, buttery transitions
• Keyboard-First: Every action has a shortcut
• Dark Theme: Easy on the eyes

• SQLite Database: All conversations saved locally
• Full-text Search: Find any message instantly
• Context Management: Screenshots, notes, clipboard history
• Session History: Resume conversations anytime

• Node.js (v18+ recommended)
• At least one AI provider API key (DeepSeek recommended for best cost/performance)

# Clone the repository
git clone <repository-url>
cd free-cluely

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env and add your API keys

Create a .env file:

# DeepSeek (Recommended - Best value)
DEEPSEEK_API_KEY=your_deepseek_key_here

# Optional: Other Providers
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GOOGLE_API_KEY=your_google_key

# Optional: Local AI
OLLAMA_BASE_URL=http://localhost:11434

npm start

This will:

1. Start Vite dev server on port 5180
2. Compile TypeScript for Electron
3. Launch the app with hot reload

npm run app:build

Creates distributable packages in release/:

• macOS: .dmg (x64, arm64)
• Windows: .exe installer + portable
• Linux: AppImage, .deb

• ⌘K / Ctrl+K - Command Palette (fuzzy search all commands)
• ⌘, / Ctrl+, - Settings
• ⌘B / Ctrl+B - Toggle Sidebar
• ⌘⇧Space - Toggle Overlay
• ESC - Close dialogs

• Enter - Send message
• Shift+Enter - New line

• ⌘1-9 - Quick actions 1-9

For comprehensive documentation including:

• Complete architecture overview
• Detailed file structure
• Code examples
• API reference
• Performance metrics
• Security details

See: HORALIX_HALO_COMPLETE.md

Beautiful glassmorphism design with real-time streaming responses.

Quick action toolbar with 9 specialized meeting assistance features.

Fuzzy search across all commands with keyboard navigation.

Manage screenshots, transcripts, notes, and clipboard history.

┌─────────────────────────────────────────────┐
│  Renderer (React + Zustand)                 │
│  ├─ ChatPanel                               │
│  ├─ ContextPanel                            │
│  ├─ MeetingToolbar                          │
│  └─ CommandPalette                          │
└─────────────────────────────────────────────┘
              ↕ IPC (window.horalix)
┌─────────────────────────────────────────────┐
│  Main Process (Electron)                    │
│  ├─ LLM Engine (5 providers)                │
│  ├─ Session Engine (SQLite)                 │
│  └─ IPC Handlers                            │
└─────────────────────────────────────────────┘

✅ Multi-provider (not locked to OpenAI) ✅ Meeting transcription ✅ Screenshot context ✅ Answer type control ✅ Session persistence ✅ Keyboard-first design

✅ Meeting mode ✅ Multi-provider ✅ Context management ✅ Cost tracking ✅ Glassmorphism UI ✅ Command palette

✅ 5 providers (was 2) ✅ SQLite persistence ✅ Beautiful UI ✅ Meeting mode ✅ Answer types ✅ Command palette

• Electron 33.2 - Desktop app framework
• React 18.3 - UI library
• TypeScript 5.6 - Type safety
• Tailwind CSS 3.4 - Styling
• Framer Motion 11 - Animations
• Zustand 5.0 - State management
• better-sqlite3 - Database
• react-markdown - Markdown rendering

# Kill processes on port 5180
lsof -i :5180
kill <PID>

# Clean install
rm -rf node_modules package-lock.json
npm install

1. Check API keys in .env
2. Verify provider is online
3. Check console logs (⌘⌥I)

# Clean build
npm run clean
npm install
npm run build

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Priority areas:

• Provider configuration UI
• Screenshot OCR integration
• STT engine for meetings
• Voice input
• Plugin system

ISC License - Free for personal and commercial use.

Inspired by Free Cluely by @prathitjoshi_

Built with ❤️ using:

• Electron, React, TypeScript
• DeepSeek, OpenAI, Anthropic, Google, Ollama
• Tailwind CSS, Framer Motion
• better-sqlite3, Zustand

For questions, feedback, or collaboration:

• Issues: GitHub Issues
• Discussions: GitHub Discussions

If Horalix Halo helps you in your work, please consider:

• ⭐ Starring this repository
• 🐛 Reporting bugs
• 💡 Suggesting features
• 🤝 Contributing code
• 📢 Spreading the word

ai-assistant electron react typescript llm chatbot openai anthropic deepseek gemini ollama meeting-assistant coding-assistant glassmorphism desktop-app cross-platform multi-provider real-time-streaming command-palette sqlite zustand

Built with 💜 by the Horalix team