Metadata-Version: 2.4
Name: helladmin-native
Version: 0.1.0a5
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Summary: Native Rust binaries + PyO3 extensions for HellAdmin (alpha)
Keywords: security,mcp,sandbox,proxy
Author: Arseniy Kustov
License-Expression: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Repository, https://github.com/reimmerse-one/helladmin

# helladmin-native

Native Rust binaries for [HellAdmin](https://github.com/reimmerse-one/helladmin). Optional acceleration — Python fallback always works.

## What's included

| Binary | What it does |
|--------|-------------|
| `helladmin-proxy` | MCP reverse proxy — auth, argument validation, rate limiting, egress guard, forwarding, audit. 11x faster than Python engine. |
| `helladmin-shell` | Sandboxed login shell — applies Landlock + seccomp on SSH login. Static binary, no Python runtime needed. |

## Installation

```bash
pip install helladmin-native
```

Requires Linux x86_64 or aarch64. Python 3.10+.

## Usage

After installation, HellAdmin auto-detects the Rust binaries:

```bash
# Proxy auto-selects Rust engine
helladmin proxy serve                     # auto (prefers Rust)
helladmin proxy serve --engine rust       # force Rust

# setup-user auto-detects Rust shell binary
sudo helladmin setup-user agent --preset developer
```

## Performance

Rust proxy is approximately **10x faster** than the Python engine with **~3x lower latency**. Both engines produce identical security decisions.

## Building from source

```bash
cd native
cargo build --release --workspace
```

Binaries in `target/release/`: `helladmin-proxy`, `helladmin-shell`, `helladmin-run`.

## License

Apache-2.0

