Halyn — Enforceable safety for AI agents. Shield rules, audit chain, dashboard.
Project description
Halyn
AI agents act in the world. Halyn makes sure they can't break it.
The safety layer for AI agents · Shield rules · Audit chain · Built-in dashboard
The Problem
AI agents are acting in the real world — deleting files, restarting servers, controlling robots. Claude has 22 MCP tools. GPT has computer use.
But who stops them from breaking things?
Today the answer is: the prompt says "be careful." That's like telling a car "don't crash" instead of installing brakes.
Halyn is the brakes.
Quick Start
pip install halyn
halyn-mcp --port 8935
# Open http://localhost:8935 → see the dashboard
30 seconds. Zero code. Working dashboard.
Dashboard
Built-in web UI. Type commands, see shields, watch the audit chain update in real-time.
Shield Rules
Constraints enforced at protocol level. The AI has no power to override them.
from halyn import ControlPlane, SSHDriver
cp = ControlPlane()
cp.connect(SSHDriver("192.168.1.10", "admin"))
cp.shield("deny * delete *") # no deletions — ever
cp.act("restart nginx") # ✓ allowed
cp.act("rm -rf /etc") # ✗ blocked — always
Not guidelines. Physics.
Audit Chain
Every action recorded in SHA-256 hash chain. Tamper-evident, append-only.
12 Drivers
SSH, HTTP, WebSocket, Serial, MQTT, OPC-UA, ROS2, DDS, Docker, Browser, Unitree, Socket.
Built on NRP
Halyn implements NRP — 6 rules that no AI can break.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file halyn-1.0.1.tar.gz.
File metadata
- Download URL: halyn-1.0.1.tar.gz
- Upload date:
- Size: 71.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
020afb45a6133663be22f15ba456935799ca23e97116540d30c1bf191de4e22a
|
|
| MD5 |
ede512a17e32fe66f5912248352213d5
|
|
| BLAKE2b-256 |
5fd641101266ada311440bc5999bb5675e0fe225eff28a692a8d686cbb94c9f5
|
File details
Details for the file halyn-1.0.1-py3-none-any.whl.
File metadata
- Download URL: halyn-1.0.1-py3-none-any.whl
- Upload date:
- Size: 89.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
954f7b36cae4913c044460e136cbd4aaa51a6f0d7fadd6f5a1f98f30259ea4b5
|
|
| MD5 |
474fbcab96777fe4cfd9512717fabb73
|
|
| BLAKE2b-256 |
a148ae4a94d3c3cc74bfd91f496e1f706aaadb1f5989ff62fff475250f84c96b
|