Muni CLI

The command-line interface for Muni. Run scientific tools on managed GPUs, inspect and download job outputs, and build canvases of tables, charts, structures, molecules, and code from a terminal, a script, or an AI agent.

Install

pipx install muni

Or pip install muni into an existing environment. Requires Python 3.11+. muni --version shows what you have; muni update --check compares it with the latest release.

muni login            # opens your browser; click Authorize
muni login --device   # no browser: prints a code to enter at app.muni.bio/device
muni whoami

For CI and agents, create a personal access token once and export it instead:

muni token create --name ci --ttl 90d
export MUNI_TOKEN=...   # the token printed above

More in muni help auth: scoped and space-pinned tokens, revocation, and profiles.

Run a tool

muni tools -q rowan                              # find a tool
muni tool rowan_solubility --inputs              # its parameters
muni run rowan_solubility smiles=CCO --dry-run   # validate and estimate cost; submits nothing
muni run rowan_solubility smiles=CCO --follow    # submit and stream status until done

Parameters are KEY=VALUE pairs parsed as JSON when possible (temperatures='[298.15, 310]'); @file reads a value from a file and --params-file params.json loads them all. muni run ipsae --batch jobs.jsonl submits one job per line.

Read results

muni job list --tool rowan_solubility -n 5
muni job status JOB_ID
muni wait JOB_ID                           # block until the job finishes
muni job summary JOB_ID                    # columns, row count, file count
muni job query JOB_ID --columns rank,sequence --limit 10
muni job files JOB_ID
muni job download JOB_ID results/summary.csv --output summary.csv
muni job download-all JOB_ID --glob "*.pdb" --output-dir ./structures/

Work on a canvas

A space holds pages, and a page holds nodes: tables, charts, structures, compounds, text, images, PDFs, JSON, code, tool jobs, and pipelines.

muni space list
muni page create "Results" --space SPACE_ID --json
muni run rowan_solubility smiles=CCO --page PAGE_ID --follow   # a job node plus result nodes
muni job materialize JOB_ID --page PAGE_ID                      # put an earlier job's results on a page
muni node create table "Screen" --file ./results.csv --page PAGE_ID
muni node list --page PAGE_ID
muni node type NODE_ID                     # its kind and the commands for it
muni node table query NODE_ID "select * from rows limit 5"

muni run without --page or --space runs detached: results stay in job storage until you materialize them. More in muni help targeting and muni help nodes.

Guides

The CLI ships its own documentation. muni help lists the topics:

Topic	Covers
`muni help agents`	the contract for scripts and AI agents: output, exit codes, IDs, spending
`muni help auth`	browser, device, and token sign-in; profiles
`muni help targeting`	spaces, pages, the directory binding, where results land
`muni help jobs`	tools, parameters, costs, waiting, outputs
`muni help nodes`	creating, editing, running, and connecting canvas nodes
`muni help pipelines`	authoring, releasing, and running pipelines
`muni help campaigns`	lab campaigns with Adaptyv
`muni help autopipe`	reading AutoPipe runs and results
`muni help exit-codes`	exit codes and error codes
`muni help environment`	environment variables
`muni help reference`	every command and flag (`--json` for a machine-readable tree)

muni COMMAND --help explains any single command.

For AI agents

Every command accepts --json and returns {"schema": 1, "data": ...} or an error object with a stable code, and exit codes are documented. Point your agent at:

muni help agents

Python SDK

The package also installs a Python client:

from muni import MuniClient

client = MuniClient()
job = client.jobs.submit("rowan_solubility", {"smiles": "CCO"})
result = client.jobs.wait(job.job_id, timeout=600)

See docs/sdk.md for the client, its namespaces, and errors.

Contributing

See AGENTS.md for the repository layout, conventions, tests, and releases, and CHANGELOG.md for what changed.

License

MIT

Release files for muni 0.2.12

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

Source distribution (sdist)

Source distribution for muni 0.2.12
File	Size	Uploaded
muni-0.2.12.tar.gz	489.7 kB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for muni 0.2.12
File	Interpreter	ABI	Platform	Reset
muni-0.2.12-py3-none-any.whl 376.3 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 865.9 kB

Release files / muni-0.2.12.tar.gz

Download URL	muni-0.2.12.tar.gz
Size	489.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`c421ae704e5fff9c408ae6f611a78019ac73d4bcb78e6d5cc6fd0a7084cc5e3f`
BLAKE2b-256 checksum How to use checksums	`82290c103aabe6cd9c7725d3c47129e0bc0d9850323c0e79578ad4b21dc983a8`
Upload date	Sep 22, 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/bioArena/muni-cli
Publishing commit: github.com/bioArena/muni-cli/tree/e3d5a0e9a8cc7cba48dfeda068afd54eeefc9fdd

Workflow

Publishing configuration: github.com/bioArena/muni-cli/blob/e3d5a0e9a8cc7cba48dfeda068afd54eeefc9fdd/.github/workflows/publish.yml
Publishing logs: github.com/bioArena/muni-cli/actions/runs/35796877056/attempts/1

Artifact

Subject: muni-0.2.12.tar.gz
SHA-256 checksum: c421ae704e5fff9c408ae6f611a78019ac73d4bcb78e6d5cc6fd0a7084cc5e3f Verifying attestations

Release files / muni-0.2.12-py3-none-any.whl

Download URL	muni-0.2.12-py3-none-any.whl
Size	376.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2356a5a58d79eb1607ac7919c2b61209c95c28acccf18f22054cf005ec23f596`
BLAKE2b-256 checksum How to use checksums	`d8993f7ac57210bdff245c89026be4769231332a4ace823e3387f77e46b99363`
Upload date	Sep 22, 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/bioArena/muni-cli
Publishing commit: github.com/bioArena/muni-cli/tree/e3d5a0e9a8cc7cba48dfeda068afd54eeefc9fdd

Workflow

Publishing configuration: github.com/bioArena/muni-cli/blob/e3d5a0e9a8cc7cba48dfeda068afd54eeefc9fdd/.github/workflows/publish.yml
Publishing logs: github.com/bioArena/muni-cli/actions/runs/35796877056/attempts/1

Artifact

Subject: muni-0.2.12-py3-none-any.whl
SHA-256 checksum: 2356a5a58d79eb1607ac7919c2b61209c95c28acccf18f22054cf005ec23f596 Verifying attestations