Skip to content

Hellig

A natural language programming framework powered by multi-agent orchestration.

Hellig treats natural language as a programming language. The hg command is its compiler + interpreter: it turns what you type into an agent program — a small sequence of instructions like say, ask the user, call an agent, invoke a tool — and runs that program on the Hellig runtime. The runtime can pause to ask follow-up questions, carry conversational state across turns, and dispatch work to any agent you register. Think of it as a tiny, hackable agent OS for the terminal in the spirit of Claude Code.

Get started Concepts GitHub

The big picture

┌───────────────┐   compile    ┌──────────────┐   execute    ┌──────────────┐
│  natural lang │ ───────────▶ │   Program    │ ───────────▶ │   Runtime    │
│  (what you    │              │  (sequence   │              │ (agents +    │
│   typed)      │              │   of ops)    │              │  tools + IO) │
└───────────────┘              └──────────────┘              └──────┬───────┘
                                                                    │
                                                              asks ↕ user

Highlights

  • Pythonic core

    A handful of small dataclasses — Agent, Instruction, Program, Runtime, Session — nothing magical, nothing hidden.

  • hg CLI

    An interactive REPL plus one-shot hg run and hg compile. Built with Click.

  • Asks back

    The ask instruction pauses execution and prompts the user mid-program. Pluggable IO adapters cover terminals, tests, and custom UIs.

  • Plug your own compiler

    Ship the default offline StubCompiler or implement Compiler.compile with any LLM to translate richer prompts.

A 30-second taste

pip install hellig
hg

hellig 0.0.1 — natural language programming.
hg » ? What city are you in? -> city
What city are you in? › Beijing
hg » : The weather in {city} looks great today.
The weather in Beijing looks great today.
hg » /scope
city = 'Beijing'

Continue with Getting started.