Local-first, agent-first blueprint automation runner.
Hadron runs typed YAML blueprints through a persistent local daemon. Blueprints are ordered, composable collections of shell tasks with validation, scheduling, pipelines, MCP access, and an append-only audit trail.
Hadron is free and open source under the MIT license. The project is being built in the open and is currently in active beta development.
Hadron is usable for local automation, daemon-backed runs, scheduling, pipelines, MCP-driven workflows, and the current first-class agentic steps.
What "beta" means today:
- APIs and workflow primitives are still being hardened
- packaging and install UX are still being improved
- the desktop app is substantially complete but still stabilizing
- some docs and ergonomics are still catching up with the live daemon
brew install hollis-labs/tap/hadroncurl -L -o hadron.tar.gz \
https://github.com/hollis-labs/hadron/releases/download/v0.4.2-beta.1/hadron_v0.4.2-beta.1_darwin_arm64.tar.gz
tar -xzf hadron.tar.gz
cd hadron_v0.4.2-beta.1_darwin_arm64
install -d "$HOME/.local/bin"
install -m 0755 hadron hadrond "$HOME/.local/bin/"
export PATH="$HOME/.local/bin:$PATH"git clone git@github.com:hollis-labs/hadron.git
cd hadron
make build
export PATH="$PWD/bin:$PATH"go install github.com/hollis-labs/hadron/cmd/hadrond@latest
go install github.com/hollis-labs/hadron/cmd/hadron@latestSee docs/install.md for prerequisites, paths, release artifacts, and first-time setup details.
# Start the daemon
hadrond serve
# Check daemon status
hadron daemon
# Run your first blueprint
hadron run examples/hello-hadron.yaml
# Validate a blueprint
hadron validate examples/parameterized.yaml
# Lint a directory of blueprints
hadron lint examples/
# Schedule a blueprint
hadron schedule create \
--blueprint examples/hello-hadron.yaml \
--cron "* * * * *" \
--name hello-every-minute
# Inspect a blueprint locally
hadron blueprint show examples/parameterized.yamlhadrond mcp -token <secret> -token-scopes run.write,schedule.write,pipeline.writeConfigure your MCP client to launch hadrond mcp over stdio. See
docs/mcp-setup.md. The MCP surface includes blueprint
broker/discovery tools, prompt templates, and resource docs in addition to the
core run/schedule/pipeline controls.
| Doc | Description |
|---|---|
| docs/getting-started.md | Installation and first run |
| docs/install.md | Source install, binary placement, and first daemon setup |
| docs/use-cases.md | Sample user and agent workflows |
| docs/beta-status.md | Current public beta posture and remaining hardening areas |
| docs/architecture/ARCHITECTURE.md | Current system architecture |
| docs/spec-v04.md | Full blueprint spec reference |
| docs/agentic-workflows.md | Current status of structured agentic workflow steps |
| docs/agent-runtime-roadmap.md | Roadmap for go-agent-runtime-backed launch and abstract messaging |
| docs/cli-reference.md | All CLI commands and flags |
| docs/mcp-setup.md | MCP client setup |
| docs/safety.md | Safety settings and trust levels |
| docs/audits/README.md | Audit conventions for deep review passes |
| File | What it demonstrates |
|---|---|
examples/hello-hadron.yaml |
Minimal blueprint |
examples/parameterized.yaml |
All input types (string, number, boolean, array, enum) |
examples/dev-cleanup.yaml |
Conditional tasks, continue_on_error, env vars |
examples/hooks-demo.yaml |
Blueprint and per-task lifecycle hooks |
examples/laravel-app.yaml |
Realistic multi-section project scaffold |
examples/agentic-message-wait-local.yaml |
Runnable local mailbox wait with self-targeted MCP message send |
examples/agentic-launch-and-wait.yaml |
Local runtime launch followed by correlated mailbox wait |
examples/pipeline-demo/ |
Multi-blueprint pipeline |
make build # build hadrond + hadron binaries
make test # run unit tests
make test-ui # run frontend tests
make typecheck
make lint # go vet + linters + vuln checks
make e2e # build + run end-to-end tests (requires built binaries)