Skip to main content

AI agent firewall for Linux servers (alpha)

Project description

helladmin (CLI package)

AI agent firewall for Linux servers. Kernel-level enforcement via Landlock LSM + seccomp-bpf. No root required.

Alpha release. Core enforcement is functional and tested. APIs may change.

Quick start

pip install helladmin

# Sandbox any process
helladmin run -- python3 my_agent.py

# Sandboxed SSH user (one-time sudo)
sudo helladmin setup-user agentuser --preset developer

# MCP proxy
helladmin proxy add --name my-server --cmd python3 server.py --access public
helladmin proxy serve --port 8443

# Dashboard
helladmin dashboard --port 8888

CLI commands

helladmin run <cmd>          Run process in Landlock + seccomp sandbox
helladmin setup-user <user>  Create sandboxed SSH user (requires sudo)
helladmin proxy add/list/remove/serve   MCP server proxy management
helladmin proxy create-key   Generate API key for key-mode servers
helladmin dashboard          Web dashboard
helladmin on/off             Legacy server protection toggle
helladmin status             Show protection status

Requirements

Linux (kernel 5.13+), Python 3.11+. No root for Tier 0.

License

Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

helladmin-0.1.0a5-py3-none-any.whl (41.6 kB view details)

Uploaded Python 3

File details

Details for the file helladmin-0.1.0a5-py3-none-any.whl.

File metadata

  • Download URL: helladmin-0.1.0a5-py3-none-any.whl
  • Upload date:
  • Size: 41.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for helladmin-0.1.0a5-py3-none-any.whl
Algorithm Hash digest
SHA256 566eba02bf13037b0725a76c749fef96ab7c4d5c61d76e64e3467ec902ad4a6d
MD5 c53727433c557adca07258eb79ea96cd
BLAKE2b-256 c69bfcd36c3c2fee862851bd6901c39e1243c66623011123563f53c4930e88e6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page