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 12, 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 12, 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.52.tar.gz (206.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.52-py3-none-any.whl (173.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: muni-0.1.52.tar.gz
  • Upload date:
  • Size: 206.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.52.tar.gz
Algorithm Hash digest
SHA256 744bcb9beb380ea7b2f4bc7d68273e89fc7ed4505b982957390a8715a16e3205
MD5 d0f7bad5a3f3991c54e5836faca5caf6
BLAKE2b-256 a91586627cf4f10c564fc05e55a3617435f3b9e99400accc3133d77a05f0ea54

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: muni-0.1.52-py3-none-any.whl
  • Upload date:
  • Size: 173.8 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.52-py3-none-any.whl
Algorithm Hash digest
SHA256 375ac15aa19ca31f33be7257f99d80532669feb2fc25acebdb74c57a701e3e89
MD5 3c2587ff8ba19569b2abdc5229a16c86
BLAKE2b-256 ad434fb2c8a3540803dee6c593b3e1e729b22eec1976263a178d4be2257cd550

See more details on using hashes here.

Provenance

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

0.1.53

2 files

This release

0.1.52 This release

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