Skip to content

openkursar/hello-halo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

316 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Halo Logo

Halo

Desktop AI Agent. Code, automate, run 7x24.

All the power of Claude Code, no terminal required. Write code, control browsers, create Digital Humans — your AI, on standby around the clock.

GitHub Stars License Platform Downloads

Download · Documentation · Contributing

简体中文 | 繁體中文 | Español | Deutsch | Français | 日本語

Space Home


Why Halo?

Halo is built on top of Claude Code, with a complete product layer totaling over 300,000 lines of code, validated by tens of thousands of users, and running stably in enterprise environments. On top of that, Halo also delivers:

What the terminal can't do Halo can
See every file AI generates Artifact Rail previews code, HTML, and images in real time
Stops when you leave the computer Remote Access — continue anytime from phone / H5 / WeChat / Android client
Have to start manually every time Digital Humans run automatically 7x24
Let non-technical colleagues use it Download and go, zero configuration
Automate browser operations AI Browser — embedded browser directly controlled by AI

Powered by Claude Code — 100% compatible with Claude Code's Agent capabilities, MCP, and Skills.


Your AI Doesn't Need You Watching

Most AI tools require you to sit in front of the screen, going back and forth in conversation. Halo is different — it can work on its own, and you only need to make decisions at key checkpoints.

Digital Humans — AI Workers Running Autonomously 7x24

Create a Digital Human, give it a task and an execution frequency, and it will run autonomously on schedule:

  • Push a tech news digest every morning
  • Check online service status every hour and notify you of anomalies
  • Run competitive analysis on a schedule and generate comparison reports
  • Monitor GitHub dependency updates and security vulnerabilities
  • Track keyword mentions across social media

Install with one click from the Digital Human Store, or create your own using natural language.

Think of it as a cron job + AI Agent hybrid — except you just speak in plain language.

Digital Humans have the exact same Agent capabilities as conversation mode — the same Claude engine, MCP toolchain, and AI Browser — they just trigger automatically on schedule without needing you at the computer.

WeChat is your control panel. Digital Humans support two-way conversational control via personal WeChat / WeCom (Enterprise WeChat) — not just receiving notifications, you can give instructions to Digital Humans, check progress, and request reports directly in WeChat.

AI Digital Human

Browser Skill — Making AI-Driven Website Operations Stable and Reliable

Typical AI browser automation has the AI fumble around figuring out what to click and fill every time, which frequently fails.

Browser Skill takes a different approach: pre-write reusable scripts for common operations on each website. The AI only needs to decide "which script to call now" — the script already handles the specifics of how to operate the website.

Skill scripts run directly in a real browser environment via Halo's browser_run — with access to the page DOM, cookies, and internal APIs, just like operating in the Chrome DevTools console. For example, here is the core code of a Bilibili notification reading Skill:

// .claude/skills/bili-get-messages/index.js
async (params) => {
  // Directly call Bilibili's internal API — cookies are automatically included, no extra authentication needed
  const resp = await fetch('https://api.bilibili.com/x/msgfeed/reply?platform=web', {
    credentials: 'include'
  }).then(r => r.json())

  // Return structured data to the AI, which decides how to respond
  return {
    success: true,
    notifications: resp.data.items.map(item => ({
      user: item.user.nickname,
      comment: item.item.source_content,
      video_title: item.item.title
    }))
  }
}

When a Digital Human calls it, all it takes is: browser_run({ file: "skills/bili-get-messages/index.js" }) — after getting the data, the AI decides which items need replies and how to reply.

For example, a Zhihu Digital Human's workflow:

  1. AI decides: time to check for new invited questions
  2. Calls zhihu-creator-invited Skill -> script automatically fetches the invitation list and returns structured data
  3. AI judges: this question is worth answering, starts writing
  4. Calls zhihu-publish-answer Skill -> script automatically fills the editor and publishes

AI makes the decisions, Skills handle the operations. Stable, repeatable, reliable.

There are already ready-made Skills for platforms like Bilibili, Zhihu, WeChat, Xiaohongshu, and more. The community can also contribute their own.

Remote Access — Your Phone Is Your AI Remote Control

Once Remote Access is enabled, your phone / H5 / WeChat / Android client can all control the Halo on your desktop. During meetings, commuting, or even from a hospital bed (true story), check AI's work progress anytime and issue new instructions.


Quick Start

Get started in 30 seconds:

  1. Download and install, launch Halo
  2. Enter your API Key (Anthropic recommended)
  3. Start chatting — try Build a todo app with React or Help me analyze the code structure of this project
  4. Watch files appear in the Artifact Rail, click to preview, request changes

Recommended models: Claude Sonnet / Opus series


Installation

Download (Recommended)

Platform Download Requirements
macOS (Apple Silicon) .dmg macOS 11+
macOS (Intel) .dmg macOS 11+
Windows .exe Windows 10+
Linux .AppImage Ubuntu 20.04+
Android .apk Android 8+
iOS Build from source iOS 15+

Download, install, run. No Node.js, no npm, no terminal needed.

Build from Source

git clone https://github.com/openkursar/hello-halo.git
cd hello-halo
npm install
npm run prepare
npm run dev

Digital Human Store

For Users — Install and Use Instantly

Open the Digital Human Store, pick one, fill in a few configuration fields, and it starts running automatically. No coding required, no prompts to write.

AI Store

For Developers — Build and Publish

Write a spec.yaml and submit a PR to the Digital Human Protocol (DHP). Once merged, it becomes immediately available to all Halo users.

You can also write Browser Skills (.js scripts) for Digital Humans to precisely execute operations on specific platforms.


Screenshots

Chat Intro

Chat Todo

Remote Access: Control Halo from anywhere

Remote Settings

Mobile Remote Access    Mobile Chat

AI Browser

ai_brower_480.mp4

Architecture

┌──────────────────────────────────────────────────┐
│                   Halo Desktop                    │
│                                                   │
│   React UI  <─IPC─>  Main Process  <──>  Claude  │
│  (Renderer)          ┌───────────┐       Code SDK │
│                      │ Digital   │      (Agent    │
│                      │ Humans    │       Loop)    │
│                      │ Scheduler │                │
│                      └───────────┘                │
│                           │                       │
│                     ~/.halo/ (local)              │
└──────────────────────────────────────────────────┘
  • 100% Local — Your data never leaves your machine (except API calls)
  • No Backend Required — Pure desktop client, use your own API Key
  • Agent Loop — Tool execution, not just text generation

More Features

  • Space System — Isolated workspaces, projects don't interfere with each other
  • Skills — Install skill packs to extend Agent capabilities
  • AI Browser — Embedded CDP browser, AI directly controls web pages
  • Multi-Model Support — Anthropic, OpenAI, DeepSeek, and any OpenAI-compatible API
  • Dark/Light Themes — Follows system preference
  • Multi-Language — Chinese, English, Spanish, and more

Roadmap

  • Claude Code SDK Agent Loop
  • Space and Conversation Management
  • Artifact Preview (Code, HTML, Images, Markdown)
  • Remote Access
  • AI Browser (CDP)
  • MCP Server Support
  • Skills System
  • Digital Humans and Digital Human Store
  • Third-party Ecosystem Plugin Compatibility
  • Enhanced Code Editing Experience
  • Visual Git + AI-Assisted Code Review
  • AI-Powered File Search

Contributing

git clone https://github.com/openkursar/hello-halo.git
cd hello-halo
npm install
npm run prepare
npm run dev
  • Translationssrc/renderer/i18n/
  • Bug ReportsIssues
  • Feature SuggestionsDiscussions
  • Code Contributions — PRs welcome

See CONTRIBUTING.md for details.


Community

WeChat Group QR Code

If the QR code has expired, add WeChat: go2halo with the note "Halo"

Personal WeChat QR Code


The Story of Halo

In October 2025, a simple frustration: I wanted to use Claude Code, but I was stuck in meetings all day.

During a boring meeting, I thought: What if I could control Claude Code on my home computer from my phone?

Then came the second problem — non-technical colleagues wanted to use it too, but got stuck at installation. "What's npm?"

So I built Halo: a visual interface, one-click install, remote access. The first version took a few hours. Everything after that? 100% built by Halo itself.

Now, we believe the next step is the AI Workstation: AI no longer needs someone watching to get work done. You set the goals, Digital Humans push forward autonomously 7x24. Writing code, running tests, monitoring deployments, generating reports — running continuously, with you only making decisions at key checkpoints.

That's what Halo is building.


License

MIT — LICENSE


Contributors

Star this repo to help more people discover Halo.

Star History Chart

Back to Top

About

7×24 Desktop AI Agent for Everyone. Visual AI assistant with remote access, file management, and built-in AI browser.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors