MirrorNeuron CLI

mn-cli provides the mn command for validating and running blueprints, inspecting runtime state, managing jobs, exporting artifacts, and starting local services installed by mn-deploy.

Quick Start

Install locally and run tests:

python3.11 -m venv .venv
. .venv/bin/activate
.venv/bin/python -m pip install -e .
.venv/bin/python -m pytest -q

Try the CLI:

mn --version
mn node list
mn blueprint run message_routing_trace

Override blueprint config for one run without changing config/overwrite.json:

mn blueprint run --folder ./vc_assistant \
  --set document_sources.folder_path=/path/to/documents \
  --set execution.debug=true

Repeat --set for multiple values. Values use JSON types when possible and otherwise remain strings.

Configuration

Configuration is loaded by mn_cli.config. .env files provide defaults, and real environment variables always override them. MN_ENV selects the environment-specific defaults file and defaults to dev when unset.

Precedence:

real environment variables
> .env.${MN_ENV}
> .env
> built-in safe defaults

Development:

export MN_ENV=dev
cp .env.example .env.dev
mn --version

Tests:

export MN_ENV=test
mn --version

Production does not require any .env file. Provide deployment-specific values through the real environment:

export MN_ENV=production
export MN_HOME=/var/lib/mirrorneuron
export MN_LOG_LEVEL=info
export MN_API_HOST=0.0.0.0
export MN_API_PORT=8080
mn runtime status

Keep secrets, credentials, production hostnames, production database URLs, cloud credentials, and user-specific local paths out of source files. Use environment variables or uncommitted .env files instead.

Details

Notes

A running MirrorNeuron core is required for live runtime commands.
The default gRPC target comes from MN_GRPC_TARGET, then local deployment settings, then localhost:55051.
Use mn blueprint validate before mn blueprint run --folder when checking a local bundle.
mn blueprint run checks the complete effective model set before preparation; if no node can satisfy it, the command reports per-node capacity reasons and does not start any model installation.

Release files for mirrorneuron-cli 1.2.27

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

Source distribution (sdist)

Source distribution for mirrorneuron-cli 1.2.27
File	Size	Uploaded
mirrorneuron_cli-1.2.27.tar.gz	366.3 kB	Jul 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mirrorneuron-cli 1.2.27
File	Interpreter	ABI	Platform	Reset
mirrorneuron_cli-1.2.27-py3-none-any.whl 251.3 kB Jul 18, 2026	Python 3	none	any	Details

Total release size: 617.7 kB

Release files / mirrorneuron_cli-1.2.27.tar.gz

Download URL	mirrorneuron_cli-1.2.27.tar.gz
Size	366.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`f05044eb234fcfb6d2f8240e71e5cfabc05888ee6dd22b5678f6befcde853262`
BLAKE2b-256 checksum How to use checksums	`be7128615ba0d4300f247752cf37531f2733e84ea6220a722c70d7cf7ef5adcc`
Upload date	Jul 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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/MirrorNeuronLab/mn-cli
Publishing commit: github.com/MirrorNeuronLab/mn-cli/tree/a96850e7b96c290b611c1c72cdafe919a772a7b3

Workflow

Publishing configuration: github.com/MirrorNeuronLab/mn-cli/blob/a96850e7b96c290b611c1c72cdafe919a772a7b3/.github/workflows/release.yml
Publishing logs: github.com/MirrorNeuronLab/mn-cli/actions/runs/29644813843/attempts/1

Artifact

Subject: mirrorneuron_cli-1.2.27.tar.gz
SHA-256 checksum: f05044eb234fcfb6d2f8240e71e5cfabc05888ee6dd22b5678f6befcde853262 Verifying attestations

Release files / mirrorneuron_cli-1.2.27-py3-none-any.whl

Download URL	mirrorneuron_cli-1.2.27-py3-none-any.whl
Size	251.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`598dd1f2a5bdea0e8c2af5d025b410438f54a2ea919da42c03e0688bd4306605`
BLAKE2b-256 checksum How to use checksums	`eecba29afd756b5c977dd3ba81a90211063b469006ef0fd530cae3c099558f23`
Upload date	Jul 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/MirrorNeuronLab/mn-cli
Publishing commit: github.com/MirrorNeuronLab/mn-cli/tree/a96850e7b96c290b611c1c72cdafe919a772a7b3

Workflow

Publishing configuration: github.com/MirrorNeuronLab/mn-cli/blob/a96850e7b96c290b611c1c72cdafe919a772a7b3/.github/workflows/release.yml
Publishing logs: github.com/MirrorNeuronLab/mn-cli/actions/runs/29644813843/attempts/1

Artifact

Subject: mirrorneuron_cli-1.2.27-py3-none-any.whl
SHA-256 checksum: 598dd1f2a5bdea0e8c2af5d025b410438f54a2ea919da42c03e0688bd4306605 Verifying attestations