typer

library0.27.1pypypi✓ verified 26d ago

Typer is a library for building CLI applications based on Python type hints, created by the author of FastAPI. It leverages type hints for argument parsing and integrates with Rich for beautiful output. The current version is 0.25.1, released in 2025, with a release cadence of several minor and patch versions per year. It requires Python >=3.10.

devops

pip install typer

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · TYPER

typer

devopspythonv0.27.1

Install

3.1s avg

Import

137ms

Disk

30MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.27.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.142s · 31.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.1s · import 0.132s · 32MB

30MB installed

● package 30MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

typer

✓ import typer

✗ from typer_cli import typer

'typer-cli' is a deprecated package, use 'typer' directly

run

✓ from typer import run

✗ from typer_cli import run

The 'typer-cli' package was discontinued in 0.24.1; use 'typer'

Typer

✓ from typer import Typer

✗ from typer_cli import Typer

Same as above

Creates a simple CLI that greets a user. Run with `python script.py World`.

import typer def main(name: str): typer.echo(f"Hello {name}") if __name__ == "__main__": typer.run(main)

typer --version

Debug

Known issues

deprecatedThe packages 'typer-cli' and 'typer-slim' are deprecated since v0.24.1; use only 'typer'.

fix

Replace `pip install typer-cli` with `pip install typer` and change imports from `typer_cli` to `typer`.

affects: >=0.24.1

breakingDropped support for Python 3.9 in v0.24.0. Python >=3.10 is required.

fix

Upgrade to Python 3.10 or higher.

affects: >=0.24.0

gotchaTyper uses Click internally, so you can use Click decorators, but mixing them can cause unexpected behavior. Prefer pure Typer patterns.

fix

Avoid mixing @click.command() and @app.command() in the same app.

affects: all

gotchaRich traceback formatting may not show local variables by default since v0.23.0. Set `rich_markup_mode='rich'` or use `typer.run(main, use_rich=True)` to control.

fix

To show locals, set `TYPER_RICH_SHOW_LOCALS=1` environment variable or pass `show_locals=True` to `Typer()`.

affects: >=0.23.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'typer_cli'

The 'typer-cli' package was deprecated and is no longer maintained.

fix

Run `pip install typer` and import as `import typer` instead of `import typer_cli`.

ImportError: cannot import name 'run' from 'typer_cli'

Using the old deprecated 'typer-cli' import path.

fix

Change import to `from typer import run`.

TypeError: __init__() got an unexpected keyword argument 'rich_markup_mode'

Using an older Typer version that does not support `rich_markup_mode` (added in v0.4.0).

fix

Update Typer with `pip install --upgrade typer`.

Upgrade

Version history

0.27.1latest on PyPI · released Aug 3, 2026

Audit

Dependencies

richrequiredRequired for pretty console output and tracebacks

shellinghamrequiredRequired for shell completion detection

clickrequiredCore dependency, Typer is built on top of Click

Agent activity

15 hits · last 30 days

node

Resources

githubhttps://github.com/fastapi/typer ↗

packagehttps://pypi.org/project/typer/ ↗

homepagehttps://typer.tiangolo.com ↗

docshttps://typer.tiangolo.com ↗

changeloghttps://typer.tiangolo.com/release-notes/ ↗