Halo Developer Guide
Halo is a local AI workstation with pluggable agent engines, browser actions, autonomous digital humans, and remote-control surfaces. This guide explains how Halo is structured, how it is installed, how its runtime works, and where to extend it.
This guide is based on the official Halo docs and the official openkursar/hello-halo repository, checked on June 26, 2026.
In this section​
- Setup and first run
- Architecture and runtime
- Configuration and security
- Extending and contributing
- Simple user guide
1. What Halo is​
The shortest accurate description is:
Halo is a local AI workstation that combines pluggable agent engines, autonomous digital workers, browser-based action scripts, and remote control into one product layer.
The README emphasizes:
- local deployment,
- digital humans,
- AI browser actions,
- remote control,
- enterprise and consumer use,
- compatibility with Claude Code, Codex, and related agent capabilities.
2. The mental model​
Think of Halo as six cooperating layers:
| Layer | What it does |
|---|---|
| workstation UI | Main user-facing desktop and web experience |
| pluggable agent engines | Connect Claude Code, Codex, and other backends |
| AI digital humans | Scheduled autonomous agents |
| browser actions | Deterministic script layer for web tasks |
| remote access | Phone, H5, WeChat, or related control surfaces |
| skills and stores | Package reusable capabilities for teams |
3. Why developers would choose it​
- It is broader than a coding assistant and acts as an AI workstation.
- It tries to combine agent reasoning with repeatable browser actions.
- It supports autonomous scheduled workers.
- It is explicitly designed for local and enterprise environments.
4. What makes it unusual​
Halo's core claim is not just "AI can click a browser." It is:
AI decides, reusable actions execute
That is an important difference because it separates reasoning from stable browser-operation scripts.
5. Recommended reading order​
- this overview,
- install and quickstart,
- architecture and browser actions,
- configuration and security,
- contribution surfaces.