{"id":46196361,"url":"https://github.com/openkursar/hello-halo","last_synced_at":"2026-04-11T07:05:04.870Z","repository":{"id":332269613,"uuid":"1133165145","full_name":"openkursar/hello-halo","owner":"openkursar","description":"Open-source Claude Code GUI — like Claude Cowork. Visual AI assistant with remote access, file management, and built-in AI browser.","archived":false,"fork":false,"pushed_at":"2026-03-03T02:00:21.000Z","size":5971,"stargazers_count":592,"open_issues_count":16,"forks_count":69,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-03T04:40:43.437Z","etag":null,"topics":["agent","claudecode","cowork"],"latest_commit_sha":null,"homepage":"https://hello-halo.cc/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openkursar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-13T01:12:25.000Z","updated_at":"2026-03-03T02:45:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/openkursar/hello-halo","commit_stats":null,"previous_names":["openkursar/hello-halo"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/openkursar/hello-halo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openkursar%2Fhello-halo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openkursar%2Fhello-halo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openkursar%2Fhello-halo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openkursar%2Fhello-halo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openkursar","download_url":"https://codeload.github.com/openkursar/hello-halo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openkursar%2Fhello-halo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30212491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T09:02:10.694Z","status":"ssl_error","status_checked_at":"2026-03-07T09:02:08.429Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","claudecode","cowork"],"created_at":"2026-03-03T03:20:46.952Z","updated_at":"2026-04-11T07:05:04.857Z","avatar_url":"https://github.com/openkursar.png","language":"TypeScript","funding_links":[],"categories":["agent"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./resources/icon.png\" alt=\"Halo Logo\" width=\"120\" height=\"120\"\u003e\n\n# Halo\n\n### 7×24 Desktop AI Agent for Everyone\n\n\nCommand your computer around the clock, drive an AI browser to complete tasks autonomously, with a friendly visual interface and full file management.\n\nWrite code, create presentations, research, draft reports, deploy servers, organize your desktop, automate browsers — if an Agent can do it, Halo supports it. Open source and free.\n\n\u003e **Our Philosophy:** Wrap complex technology into intuitive human interaction.\n\n[![GitHub Stars](https://img.shields.io/github/stars/openkursar/hello-halo?style=social)](https://github.com/openkursar/hello-halo/stargazers)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux%20%7C%20Web-lightgrey.svg)](#installation)\n[![Downloads](https://img.shields.io/github/downloads/openkursar/hello-halo/total.svg)](https://github.com/openkursar/hello-halo/releases)\n\n[Download](#installation) · [Documentation](#documentation) · [Contributing](#contributing)\n\n**[简体中文](./docs/README.zh-CN.md)** | **[繁體中文](./docs/README.zh-TW.md)** | **[Español](./docs/README.es.md)** | **[Deutsch](./docs/README.de.md)** | **[Français](./docs/README.fr.md)** | **[日本語](./docs/README.ja.md)**\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n![Space Home](./docs/assets/space_home.jpg)\n\n\u003c/div\u003e\n\n---\n\n## Why Halo?\n\nHalo is powered by Claude Code and carries the same Agent capability.\n\nThe difference: Halo brings that capability out of the terminal — giving it a visual home, an always-ready interface, and a Digital Human system that can run autonomously in the background 7×24.\n\nNo command line knowledge required. No environment setup. No staring at a screen waiting. Download, install, run — then tell it what you want done.\n\n---\n\n## Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Real Agent Loop\nNot just chat. Halo can **actually do things** — write code, create files, run commands, and iterate until the task is done.\n\n### Space System\nIsolated workspaces keep your projects organized. Each Space has its own files, conversations, and context.\n\n### Beautiful Artifact Rail\nSee every file AI creates in real-time. Preview code, HTML, images — all without leaving the app.\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Remote Access\nControl your desktop Halo from your phone or any browser. Work from anywhere — even from a hospital bed (true story).\n\n### AI Browser\nLet AI control a real embedded browser. Web scraping, form filling, testing — all automated.\n\n### AI Digital Human System\nCreate and manage autonomous AI agents (Digital Humans) that run on a schedule or in response to events — monitoring, reporting, notifying, all in the background.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### And More...\n\n- **Skills** — Install skill packs for your Agent to extend what it can do\n- **Multi-provider Support** — Anthropic, OpenAI, DeepSeek, and any OpenAI-compatible API\n- **Real-time Thinking** — Watch AI's thought process as it works\n- **Dark/Light Themes** — System-aware theming\n- **i18n Ready** — English, Chinese, Spanish (more coming)\n\n---\n\n## Digital Humans\n\nDigital Humans are autonomous AI agents that work for you in the background — monitoring, summarizing, notifying, and acting — so you don't have to.\n\nBrowse and install them directly from the **Halo Digital Human Store**, no setup required.\n\n\u003e Think of them like apps on your phone, except they work *for* you automatically.\n\n### For Users — Install in seconds\n\nOpen the Store in Halo, pick a Digital Human, configure a few fields, and it starts running. No code, no prompts, no manual effort.\n\nExamples of what Digital Humans can do for you:\n\n- Monitor prices and alert you when a deal drops\n- Deliver a daily news or market digest every morning\n- Watch your inbox and summarize what matters\n- Track social mentions of your brand or product\n- Run reports on a schedule and send them to your team\n\n### For Developers — Build and publish\n\nWant to contribute a Digital Human to the ecosystem? Write a `spec.yaml` and submit a PR to the [Digital Human Protocol (DHP)](https://github.com/openkursar/digital-human-protocol) registry — the open-source store and protocol behind Halo's Digital Humans.\n\nYour agent becomes available to all Halo users instantly after merge.\n\n*AI Store: Browse and install Digital Humans in seconds*\n\n![AI Store](./docs/assets/shop.png)\n\n*AI Digital Human: Autonomous agents running in the background*\n\n![AI Digital Human](./docs/assets/ai-digital-human.png)\n\n---\n\n## Screenshots\n\n![Chat Intro](./docs/assets/chat_intro.jpg)\n\n![Chat Todo](./docs/assets/chat_todo.jpg)\n\n\n*Remote Access: Control Halo from anywhere*\n\n![Remote Settings](./docs/assets/remote_setting.jpg)\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/mobile_remote_access.jpg\" width=\"45%\" alt=\"Mobile Remote Access\"\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"./docs/assets/mobile_chat.jpg\" width=\"45%\" alt=\"Mobile Chat\"\u003e\n\u003c/p\u003e\n\nAI Browser Video Demo\n\nhttps://github.com/user-attachments/assets/2d4d2f3e-d27c-44b0-8f1d-9059c8372003\n\n---\n\n## Advanced Features Demo\n\n[![中文](https://img.shields.io/badge/点击播放-FB7299?style=for-the-badge\u0026logo=bilibili\u0026logoColor=white)](https://www.bilibili.com/video/BV1jEZYBaEcy/)\n[![English](https://img.shields.io/badge/Watch_Video-FB7299?style=for-the-badge\u0026logo=bilibili\u0026logoColor=white)](https://www.bilibili.com/video/BV1jEZYBaEcy/)\n\n---\n\n## Installation\n\n### Download (Recommended)\n\n| Platform | Download | Requirements |\n|----------|----------|--------------|\n| **macOS** (Apple Silicon) | [Download .dmg](https://github.com/openkursar/hello-halo/releases/latest) | macOS 11+ |\n| **macOS** (Intel) | [Download .dmg](https://github.com/openkursar/hello-halo/releases/latest) | macOS 11+ |\n| **Windows** | [Download .exe](https://github.com/openkursar/hello-halo/releases/latest) | Windows 10+ |\n| **Linux** | [Download .AppImage](https://github.com/openkursar/hello-halo/releases/latest) | Ubuntu 20.04+ |\n| **Web** (PC/Mobile) | Enable Remote Access in desktop app | Any modern browser |\n\n**That's it.** Download, install, run. No Node.js. No npm. No terminal commands.\n\n### Build from Source\n\nFor developers who want to contribute or customize:\n\n```bash\ngit clone https://github.com/openkursar/hello-halo.git\ncd hello-halo\nnpm install\nnpm run prepare        # Download binary dependencies for your platform\nnpm run dev\n```\n\n\u003e To build for all platforms, run `npm run prepare:all` first to download binaries for every target platform.\n\n---\n\n## Quick Start\n\n1. **Launch Halo** and enter your API key (Anthropic recommended)\n2. **Start chatting** — try \"Create a simple todo app with React\"\n3. **Watch the magic** — see files appear in the Artifact Rail\n4. **Preview \u0026 iterate** — click any file to preview, ask for changes\n\n\u003e **Pro tip:** For best results, use Claude Sonnet 4.5 or Opus 4.5 models.\n\n---\n\n## How It Works\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                          Halo Desktop                           │\n│  ┌─────────────┐    ┌─────────────┐    ┌───────────────────┐   │\n│  │   React UI  │◄──►│    Main     │◄──►│  Claude Code SDK  │   │\n│  │  (Renderer) │IPC │   Process   │    │   (Agent Loop)    │   │\n│  └─────────────┘    └─────────────┘    └───────────────────┘   │\n│                            │                                    │\n│                            ▼                                    │\n│                    ┌───────────────┐                           │\n│                    │  Local Files  │                           │\n│                    │  ~/.halo/     │                           │\n│                    └───────────────┘                           │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n- **100% Local** — Your data never leaves your machine (except API calls)\n- **No Backend Required** — Pure desktop client, use your own API keys\n- **Real Agent Loop** — Tool execution, not just text generation\n\n\u003e **Powered by [Claude Code](https://github.com/anthropics/claude-code)** — Thanks to Anthropic for building the most capable AI agent.\n\n---\n\n## What People Are Building\n\nHalo isn't just for developers. We've seen:\n\n- **Finance teams** building full-stack apps from scratch — with zero coding experience\n- **Content creators** researching, writing, and organizing with AI in one flow\n- **Operations teams** using Digital Humans to generate daily reports, monitor competitors, and summarize trends\n- **Designers** prototyping interactive mockups\n- **Students** learning to code with AI as their pair programmer\n- **Developers** using the AI Browser for automated testing, scraping, and server deployment\n\nThe barrier isn't AI capability anymore. **It's accessibility.** Halo removes that barrier.\n\n---\n\n## Roadmap\n\n- [x] Core Agent Loop with Claude Code SDK\n- [x] Space \u0026 Conversation management\n- [x] Artifact preview (Code, HTML, Images, Markdown)\n- [x] Remote Access (browser control)\n- [x] AI Browser (CDP-based)\n- [x] MCP Server support\n- [x] Skills system\n- [x] Digital Humans \u0026 Digital Human Store\n- [x] AI Plugin App Store\n- [ ] Third-party ecosystem plugin compatibility\n- [ ] Enhanced code editing experience (reduce reliance on external editors like VS Code)\n- [ ] Visual Git with AI-assisted review\n- [ ] AI-powered file search\n\n---\n\n## Contributing\n\nHalo is open source because AI should be accessible to everyone.\n\nWe welcome contributions of all kinds:\n\n- **Translations** — Help us reach more users (see `src/renderer/i18n/`)\n- **Bug reports** — Found something broken? Let us know\n- **Feature ideas** — What would make Halo better for you?\n- **Code contributions** — PRs welcome!\n\n```bash\n# Development setup\ngit clone https://github.com/openkursar/hello-halo.git\ncd hello-halo\nnpm install\nnpm run prepare        # Download binary dependencies for your platform\nnpm run dev\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n---\n\n## Community\n\n- [GitHub Discussions](https://github.com/openkursar/hello-halo/discussions) — Questions \u0026 ideas\n- [Issues](https://github.com/openkursar/hello-halo/issues) — Bug reports \u0026 feature requests\n\n---\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details.\n\n---\n\n## Inspired by Halo?\n\nIf this project sparked an idea or helped you build something cool:\n\n- **Give us a star** — it helps others find Halo\n- **Share your story** — we love hearing what you built\n- **Link back to us** — e.g. `Inspired by [Halo](https://github.com/openkursar/hello-halo)`\n\n---\n\n## The Story Behind Halo\n\nIn October 2025, it started with a simple frustration: **I wanted to use Claude Code, but I was stuck in meetings all day.**\n\nDuring boring meetings (we've all been there), I thought: *What if I could control Claude Code on my home computer from my phone?*\n\nThen came another problem — my non-technical colleagues wanted to try Claude Code after seeing what it could do. But they got stuck at installation. *\"What's npm? How do I install Node.js?\"* Some spent days trying to figure it out.\n\nSo I built Halo for myself and my friends:\n- **Visual interface** — no more staring at terminal output\n- **One-click install** — no Node.js, no npm, just download and run\n- **Remote access** — control from phone, tablet, or any browser\n\nThe first version took a few hours. Everything after that? **100% built by Halo itself.** Since then, we've been using it 7×24.\n\nAI building AI. Now in everyone's hands.\n\n---\n\n## Contributors\n\n\u003ca href=\"https://github.com/openkursar/hello-halo/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=openkursar/hello-halo\" /\u003e\n\u003c/a\u003e\n\nMade with ❤️ by our contributors.\n\n\u003cdiv align=\"center\"\u003e\n\n### Built by AI, for humans.\n\nIf Halo helps you build something amazing, we'd love to hear about it.\n\n**Star this repo** to help others discover Halo.\n\n[![Star History Chart](https://api.star-history.com/svg?repos=openkursar/hello-halo\u0026type=Date)](https://star-history.com/#openkursar/hello-halo\u0026Date)\n\n[⬆ Back to Top](#halo)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenkursar%2Fhello-halo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenkursar%2Fhello-halo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenkursar%2Fhello-halo/lists"}