Halo is a user-friendly desktop application that brings the power of AI to your fingertips. Built with Electron and React, it provides a seamless interface for AI-powered productivity without requiring technical expertise.

• 🤖 AI Agents: Specialized AI assistants for complex tasks (Code Review, Debugging, Data Analysis, etc.)
• 🔍 Enhanced Web Search: Advanced search with domain filtering, AI summarization, and relevance scoring
• 🚀 Agent Execution History: Track and review all agent tasks with structured results
• 📊 Improved Research Tools: File analysis and web research with context-aware insights

• 💰 Cost Tracking & Analytics: Monitor AI usage and costs in real-time
• 🤖 Model Selection: Choose from latest models (Haiku 3.5, Sonnet 3.7/4, Opus 4/4.1)
• 👤 Persistent User Profiles: Settings and data persist across sessions
• 📊 Real Data Management: No more dummy data - all dashboards use real, persistent data
• 🔄 Smart Onboarding: Skip onboarding on return visits
• 📈 Usage Analytics: Track trends, get optimization suggestions

• 👤 Personalized Onboarding: Role selection for customized experience (PM, Designer, Marketing, Developer, etc.)
• 🔐 Secure Authentication: Connect with your Anthropic API key or use Quick Start mode
• 💬 AI Chat Interface: Natural language interaction with context-aware suggestions
• 📁 File Management: Full-featured file explorer with create, edit, delete, and search
• ✅ Task Management: Complete task system with priorities, filtering, and persistence
• 🧠 Memory System: Context retention across sessions with smart suggestions
• ⚡ YOLO/Careful Modes: Choose between fast execution or safe confirmations
• 🎨 Adaptive UI: Role-based dashboards and personalized workflows
• 🌓 Theme Support: Light, Dark, and Auto theme modes

• AI Agents: Specialized assistants for code review, debugging, data analysis, content writing, and research
• Advanced Web Search: Enhanced search with AI-powered summaries and domain filtering
• AI Model Selection: Choose between multiple models based on your needs
• Cost Tracking: Real-time monitoring of AI usage and spending
• Budget Management: Set daily/monthly limits with alerts
• Smart Suggestions: Time and context-aware recommendations
• Role-Specific Dashboards: Tailored interfaces for different professions
• Project Tracking: Monitor progress, deadlines, and blockers
• Conversation Memory: Remembers context from previous interactions
• File Operations: Browse, edit, search, and organize files
• Task Workflows: Create, prioritize, and track tasks with statuses
• Settings Management: Comprehensive preferences and customization
• Data Persistence: All your data is saved locally and persists across sessions

1. Download Halo Desktop

   • macOS: Download the .dmg file
   • Windows: Coming soon
   • Linux: Coming soon

2. Install

   • macOS: Open the DMG and drag Halo to Applications
   • Windows: Run the installer
   • Linux: Make AppImage executable and run

3. Launch & Setup

   • Open Halo from your Applications/Start Menu
   • Choose your role (PM, Designer, Developer, etc.)
   • Enter your API key or use Quick Start mode

• Node.js 18.0.0 or higher
• npm or yarn
• An Anthropic API key (optional - Quick Start mode available)

1. Clone the repository:

git clone https://github.com/alinaqi/halo.git cd halo

2. Install dependencies:

npm install

3. Set up environment variables (optional): Create a .env file in the root directory:

ANTHROPIC_API_KEY=your_api_key_here

4. Start the application:

npm run dev

npm run build npm run dist

# macOS npm run dist:mac # Windows npm run dist:win # Linux npm run dist:linux

Halo now supports the latest models with easy switching:

• Haiku 3.5 - Fast and cost-effective for quick tasks
• Sonnet 3.7 - Balanced performance for most use cases
• Sonnet 4 - High performance with advanced capabilities
• Opus 4 - Very high intelligence for complex tasks
• Opus 4.1 - Most capable model for demanding applications

Switch models anytime in Settings → API → Model Selection

Halo is built with a modern, secure architecture:

• Frontend: React + TypeScript + Tailwind CSS
• Desktop Framework: Electron
• Build Tool: Vite
• AI Integration: Anthropic SDK
• State Management: React Context + Memory Service
• Storage: localStorage + Electron secure storage
• Security: Electron's contextIsolation and secure IPC

halo/ ├── electron/ # Electron main process │ ├── main.cjs # Main entry point │ ├── preload.cjs # Preload script for security │ └── services/ # Backend services ├── src/ # React application │ ├── components/ # UI components │ ├── contexts/ # React contexts │ ├── hooks/ # Custom React hooks │ └── lib/ # Utility libraries ├── dist/ # Production build output └── release/ # Electron distribution packages 

• API keys are encrypted and stored locally using Electron's safeStorage API
• No data is sent to external servers except for AI API calls
• Context isolation ensures web content cannot access Node.js APIs directly
• All file operations are sandboxed to designated workspace directories

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to your branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

• Built with Electron
• UI powered by React and Tailwind CSS
• AI capabilities via Anthropic
• Icons from Lucide React

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Halo Desktop - Making AI accessible to everyone 🚀