Muni CLI

Muni is the command-line interface for the Muni platform. Use it to discover available tools, submit jobs, monitor runs, download outputs, and work with spaces and canvas nodes from your terminal.

Install

pipx install muni

Or install into an existing environment:

pip install muni

Requires Python 3.11 or newer.

Log in

muni login

On a server or SSH session without a browser:

muni login --device

Check the active account:

muni whoami

Common Workflow

Find a tool:

muni tools
muni tools --category protein-design
muni tools -q rfd3

Inspect tool inputs:

muni tool rfd3 --inputs
muni tool rfd3 --examples

Submit a job:

muni run rfd3 pdb_id=1UBQ num_designs=5

Submit and wait for completion:

muni run rfd3 pdb_id=1UBQ num_designs=5 --follow

Submit parameters from JSON:

muni run rfd3 --params-file params.json --follow

Run a batch from JSONL:

muni run ipsae --batch jobs.jsonl --follow
cat jobs.jsonl | muni run ipsae --batch - --follow

Check status and retrieve outputs:

muni status job_<uuid>
muni wait job_<uuid>
muni results job_<uuid>
muni results job_<uuid> --fields rank,sequence
muni files job_<uuid>
muni download-all job_<uuid> -o ./results/

Pipeline Workspaces

Create and validate an agent-ready pipeline workspace:

muni pipeline init ./my-pipeline
cd ./my-pipeline
muni pipeline check --json

The JSON check response is compact by default: it reports pipeline identity, tools, stage order, issues, compiler provenance, artifact digests, and written paths. The complete manifest and run plan are still written under .muni/build/; use muni pipeline check --json --full when those large values must also be returned on stdout. muni pipeline dashboard push compiles and saves dashboard source through the canonical Muni app/Canvas path, then writes the full server-returned artifact locally while printing only a bounded hash/version/diagnostics summary. Successful checks record a short-lived server receipt, and muni pipeline release obtains and submits a fresh receipt before publishing.

Spaces and Canvas Nodes

List and choose a workspace:

muni spaces
muni spaces -q protein --limit 50
muni spaces --roles       # show your email and role in each space
muni spaces --all --json  # fetch every matching page
muni space use             # choose interactively
muni space use "My Space"  # or pass a name/ID
muni page use              # choose a page in the active space

Once selected, muni run, muni job materialize, muni nodes, and muni node default to that active space/page. Canvas-targeted muni run creates and submits a real job node so completion can add deterministic result nodes to the canvas. Use --space-id or --page-id to override one command, or muni space use none / muni run ... --no-space for API-only jobs.

Control result-node creation explicitly when needed:

muni run rfd3 pdb_id=1UBQ --auto-materialize
muni run rfd3 pdb_id=1UBQ --no-auto-materialize

--auto-materialize requires a selected space/page and cannot be combined with --no-space, --no-nodes, or the legacy --no-result-nodes flag. Omitting both Boolean flags preserves the existing default.

List nodes on the active page:

muni nodes
muni nodes search "PXDesign"

Create or inspect nodes:

muni node create table "Results"
muni node create structure "TREM2 rank 1" --file ./rank_1.cif
muni node read <node_id>
muni node submit <node_id> --wait

Command Reference

Command What it does
muni login Authenticate the CLI
muni whoami Show the current account
muni balance Show credit balance
muni tools List available tools
muni tool <name> Show details for one tool
muni run <tool> KEY=VALUE Submit a job
muni jobs List recent jobs
muni jobs --tool ipsae Filter recent jobs by tool
muni status <job_id> Check a job
muni wait <job_id> Wait for one or more jobs
muni results <job_id> Print job results
muni files <job_id> List job output files
muni download <job_id> <path> Download one output file
muni download-all <job_id> Download all output files
muni spaces List spaces with pagination
muni spaces -q <query> Search spaces by name or member email
muni spaces --roles List spaces with your email and role
muni space <subcommand> Manage a space
muni nodes List canvas nodes
muni node <subcommand> Create, read, edit, connect, or run nodes

Run muni --help or muni <command> --help for the full set of options.

License

MIT

Project links

Data verified by PyPI on Jul 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dereka from gravatar.com dereka

Credits

Author: BioArena

GitHub Statistics

Data verified by PyPI on Jul 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

bioarena muni cli bioinformatics protein-design

Classifiers

Report project as malware

Download files

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

Source Distribution

muni-0.1.64.tar.gz (297.5 kB view details)

Uploaded Source

Built Distribution

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

muni-0.1.64-py3-none-any.whl (203.3 kB view details)

Uploaded Python 3

File details

Details for the file muni-0.1.64.tar.gz.

File metadata

  • Download URL: muni-0.1.64.tar.gz
  • Upload date:
  • Size: 297.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for muni-0.1.64.tar.gz
Algorithm Hash digest
SHA256 d75a15ab590f9ee80722a22836ebb234b67ad8be61591c85fae23381bd807469
MD5 7fa6589b2264bfe589380d0eb37f2479
BLAKE2b-256 770af8b6b5cfe537fe7fb760a6ce786ddd520c0cf0ab00e990cc2b53dffba10d

See more details on using hashes here.

Provenance

The following attestation bundles were made for muni-0.1.64.tar.gz:

Publisher: publish.yml on bioArena/muni-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file muni-0.1.64-py3-none-any.whl.

File metadata

  • Download URL: muni-0.1.64-py3-none-any.whl
  • Upload date:
  • Size: 203.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for muni-0.1.64-py3-none-any.whl
Algorithm Hash digest
SHA256 5c8f15c9b2d163aa9bb99c0ab9f859f6a98bcc8cfc39fb0d7d46db16f9bc1744
MD5 4b04083f2b75b799b3c68e7bd6cc8441
BLAKE2b-256 d4b2164b6ad93d005c674166ba368d105b2fe964d7b7cedd379847562f9f24fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for muni-0.1.64-py3-none-any.whl:

Publisher: publish.yml on bioArena/muni-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.71

2 files

0.1.70

2 files

0.1.69

2 files

0.1.68

2 files

0.1.67

2 files

0.1.66

2 files

0.1.65

2 files

This release

0.1.64 This release

2 files

0.1.63

2 files

0.1.62

2 files

0.1.61

2 files

0.1.60

2 files

0.1.59

2 files

0.1.58

2 files

0.1.57

2 files

0.1.56

2 files

0.1.55

2 files

0.1.54

2 files

0.1.53

2 files

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

0.1.49

2 files

0.1.48

2 files

0.1.47

2 files

0.1.46

2 files

0.1.45

2 files

0.1.44

2 files

0.1.43

2 files

0.1.42

2 files

0.1.41

2 files

0.1.40

2 files

0.1.39

2 files

0.1.38

2 files

0.1.37

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

0.1.33

2 files

0.1.32

2 files

0.1.31

2 files

0.1.30

2 files

0.1.29

2 files

0.1.28

2 files

0.1.27

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

Supported by

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