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 nodes --apply, 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.

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 11, 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 11, 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.49.tar.gz (213.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.49-py3-none-any.whl (170.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: muni-0.1.49.tar.gz
  • Upload date:
  • Size: 213.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.49.tar.gz
Algorithm Hash digest
SHA256 5ce1f6903d5a948d069ffa52ab868223eaa65fe79266920dcbf6ca9f1276e113
MD5 0c08fe62b3c8abe0247204b2eb4a4c84
BLAKE2b-256 dfefee813f5ddc97021792aeb5f82b3f41a7d504e5e9afb3b8d96612314860cb

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: muni-0.1.49-py3-none-any.whl
  • Upload date:
  • Size: 170.9 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.49-py3-none-any.whl
Algorithm Hash digest
SHA256 06520459128e86a7c378638aa3e010effb562bbb8863bfc16212c8874921346f
MD5 24c0a21297833d188ece34e27aed26c0
BLAKE2b-256 2be29c5b0e1edf3d7de6692365198027c045d241e102e92749a7734f67e9021b

See more details on using hashes here.

Provenance

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

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

This release

0.1.49 This release

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