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/

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 "Results" --type table
muni node create "TREM2 rank 1" --type structure --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 13, 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 13, 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.53.tar.gz (212.2 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.53-py3-none-any.whl (177.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for muni-0.1.53.tar.gz
Algorithm Hash digest
SHA256 37dacdd74f402bca81c91e47f4750e330ecc0e4fbca8930d933c966674346bee
MD5 167dbe75835314af1d01734dc3c3ca0a
BLAKE2b-256 c094bc827a839bee2b4763de96b6d511b9f29f00b74179ef861517e70d997417

See more details on using hashes here.

Provenance

The following attestation bundles were made for muni-0.1.53.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.53-py3-none-any.whl.

File metadata

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

File hashes

Hashes for muni-0.1.53-py3-none-any.whl
Algorithm Hash digest
SHA256 8bf676b94f0e91177ce6ef000f67f7e81cfa51d553aa7665c368b35283d6e93e
MD5 3529acbe354db2c695dfdbece84ee03e
BLAKE2b-256 eb5316c1ae352fd1db1076ba19e045ede6c86db51e7ca66fce80ab8b216cf133

See more details on using hashes here.

Provenance

The following attestation bundles were made for muni-0.1.53-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

0.1.64

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

This release

0.1.53 This release

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