Alenia Nerve — Python Client & CLI Hub

This is the official Python client library and Command Line Interface (CLI) for Alenia Nerve, the ultra-fast local inter-process communication (IPC) engine.

The Nerve CLI Hub

The Python package includes the central CLI tool (nerve) used to boot and manage the central IPC routing Hub.

CLI Commands Reference

Nerve provides a comprehensive suite of commands to manage the IPC Hub, monitor traffic, and securely pack/unpack data.

Hub & Monitoring

nerve start: Starts the central Nerve Hub (blocking process). Use --verbose for detailed real-time message routing logs.
nerve monitor: Launches an interactive, terminal-based UI to view real-time hub statistics, connected nodes, and message throughput.
nerve dashboard: Starts a visual web dashboard accessible at http://localhost:8080 to monitor the local Nerve network.
nerve bridge: Starts the HTTP/WebSocket bridge (default port 50506) to allow external applications (e.g., browsers, remote clients) to securely communicate with the local Nerve IPC network.

Secure Containers (.nrv)

Nerve includes a high-security encrypted container format (.nrv) protected with AES-GCM and Argon2id.

nerve pack <src> <out.nrv>: Packs a file or directory into a secure .nrv container. It will prompt for a password or use the NERVE_NRV_PASSWORD environment variable.
nerve unpack <file.nrv> <out_dir>: Decrypts and unpacks a .nrv container into the specified output directory.
nerve open <file.nrv>: Interactive command to open a .nrv container. It handles up to 3 password retries and uses native GUI prompts if run outside a terminal.
nerve associate: Registers the .nrv file extension with your Operating System (Windows/macOS/Linux) and sets Nerve as the default application to open them.
nerve unassociate: Removes the .nrv file association from your system.
nerve genpass [--mode random|passphrase] [--length N] [--words N]: Generates a cryptographically secure random password or memorable passphrase.

Client Installation

Install the package via pip:

pip install alenia-nerve

Or install it globally bypassing system package restrictions if needed (e.g., inside containers):

pip install alenia-nerve --break-system-packages

Integration Example

1. Initialize Client

Connect to the local hub by registering a unique client ID.

from nerve import NexusClient

client = NexusClient()
client.connect("my_python_node")

2. Send messages

Send a JSON-serializable payload directly to another registered node:

payload = {"status": "processing", "progress": 45}
client.send("renderer_node", payload)

3. Broadcast messages

Broadcast a payload to every other node currently connected to the Hub:

client.broadcast({"event": "reload_assets"})

4. Listen for streams

def handle_incoming(data):
    print(f"Received: {data}")


client.listen(handle_incoming)

License

This software is distributed under the GNU General Public License v3 (GPL v3).

Credits

The secure password generator uses the EFF Large Wordlist created by the Electronic Frontier Foundation, distributed under the Creative Commons Attribution 3.0 License (CC BY 3.0).

Release files for alenia-nerve 1.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alenia-nerve 1.6.1
File	Size	Uploaded
alenia_nerve-1.6.1.tar.gz	422.0 kB	Sep 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for alenia-nerve 1.6.1
File	Interpreter	ABI	Platform	Reset
alenia_nerve-1.6.1-py3-none-any.whl 411.2 kB Sep 2, 2026	Python 3	none	any	Details

Total release size: 833.2 kB

Release files / alenia_nerve-1.6.1.tar.gz

Download URL	alenia_nerve-1.6.1.tar.gz
Size	422.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`d7eb0970063cf657365d9eb9d24f1a7a1f4974f9a172f436722a0bd6bfea825f`
BLAKE2b-256 checksum How to use checksums	`78b9090dd519ef1892c0ca5e81109742e94544de3461743e1ed94c0116181a67`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Kaia-Alenia/alenia-nerve
Publishing commit: github.com/Kaia-Alenia/alenia-nerve/tree/a782700a041a606c4b67d8f3622e6ce4ae908446

Workflow

Publishing configuration: github.com/Kaia-Alenia/alenia-nerve/blob/a782700a041a606c4b67d8f3622e6ce4ae908446/.github/workflows/publish.yml
Publishing logs: github.com/Kaia-Alenia/alenia-nerve/actions/runs/33577172335/attempts/1

Artifact

Subject: alenia_nerve-1.6.1.tar.gz
SHA-256 checksum: d7eb0970063cf657365d9eb9d24f1a7a1f4974f9a172f436722a0bd6bfea825f Verifying attestations

Release files / alenia_nerve-1.6.1-py3-none-any.whl

Download URL	alenia_nerve-1.6.1-py3-none-any.whl
Size	411.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`49f4d7fba87abd87144a26d7cf5e1058deea9bff0bddc5b7316d4790548c3154`
BLAKE2b-256 checksum How to use checksums	`5664b64acd4a0e8c198db3fd24a8c264b66cb2e78973fd1d63a0578d22602fa9`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Kaia-Alenia/alenia-nerve
Publishing commit: github.com/Kaia-Alenia/alenia-nerve/tree/a782700a041a606c4b67d8f3622e6ce4ae908446

Workflow

Publishing configuration: github.com/Kaia-Alenia/alenia-nerve/blob/a782700a041a606c4b67d8f3622e6ce4ae908446/.github/workflows/publish.yml
Publishing logs: github.com/Kaia-Alenia/alenia-nerve/actions/runs/33577172335/attempts/1

Artifact

Subject: alenia_nerve-1.6.1-py3-none-any.whl
SHA-256 checksum: 49f4d7fba87abd87144a26d7cf5e1058deea9bff0bddc5b7316d4790548c3154 Verifying attestations