yeetr, build tiny CLIs. Easy to code. Based on Python type hints.

yeetr

A tiny, typed, signature-driven CLI runner. Supports Python 3.13 and 3.14.

No decorators. No command classes. No ceremony. Just yeet the function.

Write a plain function, run it from the command line — yeetr turns the signature into args and options for you:

# app.py
def main(thing: int, *, n: float = 0.1) -> None:
    print(thing, n)

yeet app.py 5 -n 0.2

No if __name__ == "__main__" block, no yeetr.run(...) call, no decorators. Parameters before the bare * become positional args, parameters after it become --options.

Install

uv add yeetr

Highlights

Zero boilerplate — yeet app.py finds and runs main — or any public function you name — and scaffolds the file if it doesn't exist yet.
Executable shebangs — #!yeet makes a script runnable on its own; #!yeet FUNC picks the function to run.
Fully typed — str, int, float, bool, Path, datetime, date, time, UUID, Decimal, Literal, Enum, T | None, list[T], tuples, and structured dataclass/NamedTuple args, all Pyright-strict clean.
Async-native — async def main just works, with automatic uvloop if it's installed.
Rich output — formatted logging and help/error tables out of the box.

yeetr help output

Docs

The full guide — parameter metadata, env var fallback, path validators, runtime behavior, a yeetr vs. typer comparison, and the API reference — lives at rogerthomas.github.io/yeetr.

Contributing

See CONTRIBUTING.md for how to set up a dev environment, run the test suite, and submit changes.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yeetr-2026.7.29.tar.gz (3.4 MB view details)

Uploaded Jul 29, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

yeetr-2026.7.29-py3-none-any.whl (18.1 kB view details)

Uploaded Jul 29, 2026 Python 3

File details

Details for the file yeetr-2026.7.29.tar.gz.

File metadata

Download URL: yeetr-2026.7.29.tar.gz
Upload date: Jul 29, 2026
Size: 3.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for yeetr-2026.7.29.tar.gz
Algorithm	Hash digest
SHA256	`26c92e48e46ed09e6488978cbaafb3e2cf25d730acb62142f6dab0400b0cf884`
MD5	`9cb99ace52dd57a54f08545e43fa6278`
BLAKE2b-256	`b129dfc4177374bc886fe1e3d8000cc9c5cc145b6336de93c1cad5587b6123c6`

See more details on using hashes here.

File details

Details for the file yeetr-2026.7.29-py3-none-any.whl.

File metadata

Download URL: yeetr-2026.7.29-py3-none-any.whl
Upload date: Jul 29, 2026
Size: 18.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for yeetr-2026.7.29-py3-none-any.whl
Algorithm	Hash digest
SHA256	`5d7c28f782586a3938477afd8fb88f5ec587633f5d569c76e5b18b00789088a8`
MD5	`e5084afcd92d71bed7f07f7f07401e00`
BLAKE2b-256	`520c3aabe509df25825e0952bf9fc8f6f0c5e807b3cae53ca43f4c4370b5da55`