---
id: pyodide-cli
version: "0.5.0"
license: MPL-2.0
license_treatment: copyleft
maintenance: active
---

# pyodide-cli — "The command line interface for the Pyodide project"

License: copyleft · Maintenance: active · Downloads: 126.0K/mo

## What it is and what it does

pyodide-cli is the command-line interface layer for the Pyodide project, built on click and rich for command handling and terminal output. It serves primarily as a plugin host: other packages in the Pyodide ecosystem (such as pyodide-build, pyodide-pack, and auditwheel-emscripten) depend on it and register their own subcommands via setuptools entry points, allowing them to extend the main `pyodide` command without modifying this package directly.

Developers building tools for the Pyodide ecosystem use pyodide-cli as a foundation by adding a dependency on it and registering a `pyodide.cli` entry point that points to a click command or typer app. The package handles command discovery and dispatch, so each tool can contribute its own subcommand to a unified CLI interface.

Use it for:

- Extending the Pyodide CLI with custom subcommands from your own package via entry points
- Building Pyodide ecosystem tools that integrate with the main `pyodide` command
- Centralizing CLI infrastructure for related Pyodide build and packaging tools
- Registering click or typer-based commands that appear under the main `pyodide` namespace

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line interface for the Pyodide project that provides core CLI functionality and allows other packages to register subcommands via entry points.

Yes, if you are developing tools for the Pyodide ecosystem or need to register subcommands in the Pyodide CLI. The package is actively maintained, has low install friction, and is designed to be a dependency of other ecosystem packages rather than a standalone tool. Direct installation is typically unnecessary unless you are extending Pyodide's CLI.

## Install

pip install pyodide-cli
uv add pyodide-cli
poetry add pyodide-cli

## Installing pyodide-cli

Before you install: Low install friction with only two lightweight runtime dependencies (click and rich). Actively maintained with recent releases; the repository is current and well-established within the Pyodide ecosystem.

License in practice: Licensed under MPL-2.0 (copyleft). You may use and modify the package freely, but derivative works must be distributed under the same license and source code must be made available.

Quickstart:

pip install pyodide-cli

# In your package's setup.cfg or pyproject.toml, register a subcommand:
# [project.entry-points."pyodide.cli"]
# my_command = "mypackage.cli:main"

# Then users can run: pyodide my_command

Requires Python 3.12 or later.

Verify before relying:

- Whether this package is typically installed directly or only as a transitive dependency of other Pyodide ecosystem packages

## Package facts

- License: MPL-2.0 (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 126.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyodide cli tool, command line interface for pyodide, pyodide subcommand registration, cli entry point framework, pyodide ecosystem cli, cli-framework, pyodide-ecosystem, entry-point-plugin

[View on SkillFed](https://skillfed.io/packages/pyodide-cli) · [View on PyPI](https://pypi.org/project/pyodide-cli/)