| Port variant | v14 |
| Summary | Command line interface builder (3.14) |
| Package version | 0.26.4 |
| Homepage | https://github.com/fastapi/typer |
| Keywords | python |
| Maintainer | Python Automaton |
| License | Not yet specified |
| Other variants | v13 |
| Ravenports | Buildsheet | History |
| Ravensource | Port Directory | History |
| Last modified | 30 MAY 2026, 23:31:11 UTC |
| Port created | 25 FEB 2026, 19:33:15 UTC |
| single | [image] Typer, build great CLIs. Easy to code. Based on Python type hints. [image] [image] [image] [image] --- **Documentation**: [https://typer.tiangolo.com] **Source Code**: [https://github.com/fastapi/typer] --- Typer is a library for building CLI applications that users will **love using** and developers will **love creating**. Based on Python type hints. It's also a command line tool to run scripts, automatically converting them to CLI applications. The key features are: * **Intuitive to write**: Great editor support. Completion everywhere. Less time debugging. Designed to be easy to use and learn. Less time reading docs. * **Easy to use**: It's easy to use for the final users. Automatic help, and automatic completion for all shells. * **Short**: Minimize code duplication. Multiple features from each parameter declaration. Fewer bugs. * **Start simple**: The simplest example adds only 2 lines of code to your app: **1 import, 1 function call**. * **Grow large**: Grow in complexity as much as you want, create arbitrarily complex trees of commands and groups of subcommands, with options and arguments. * **Run scripts**: Typer includes a `typer` command/program that you can use to run scripts, automatically converting them to CLIs, even if they don't use Typer internally. ## FastAPI of CLIs **Typer** is [FastAPI]'s little sibling, it's the FastAPI of CLIs. ## Installation Create and activate a [virtual environment] and then install **Typer**:
```console
$ pip install typer
---> 100%
Successfully installed typer rich shellingham
```
## Example
### The absolute minimum
* Create a file `main.py` with:
```Python
def main(name: str):
print(f"Hello {name}")
```
This script doesn't even use Typer internally. But you can use the `typer`
command to run it as a CLI application.
### Run it
Run your application with the `typer` command:
```console
// Run your application
$ typer main.py run
// You get a nice error, you are missing NAME
Usage: typer [PATH_OR_MODULE] run [OPTIONS] NAME
Try 'typer [PATH_OR_MODULE] run --help' for help.
╭─ Error
|
| Build (only) |
python314:dev:std python-pip:single:v14 autoselect-python:single:std |
| Build and Runtime | python314:primary:std |
| Runtime (only) |
python-shellingham:single:v14 python-rich:single:v14 python-annotated-doc:single:v14 |
| main | mirror://PYPIWHL/f0/6d/5a525c69df4a90892135e5d490b00e9e46402491f3416d4395fcb0d0201e |
| python-typer-slim:v14 | Command line interface builder (slim) (3.14) |