Installation
Get create-awesome-python-app running in seconds. Choose the install method that fits your workflow.
No global install required
uvx create-awesome-python-app@latest — no global install needed. Python 3.12+ is required for generated projects; uv installs the CLI on the fly.Install methods
Run without installing (recommended):
Pin a version:
Install with pipx (optional):
After install you can run create-awesome-python-app my-app directly.
Install with pip into a virtualenv (optional):
Python 3.12 or later
Check with python --version. Install via uv python install, pyenv, or python.org.
uv (recommended)
Install from docs.astral.sh/uv. Check with uv --version.
git
Used to initialize the project repository after scaffolding.
Verify the installation
After installing, confirm the CLI is available and shows the correct version:
Or list all available templates to confirm the CLI can reach the catalog:
Keeping up to date
uvx
uvx create-awesome-python-app@latest my-app
pipx
pipx upgrade create-awesome-python-app
Homebrew
brew upgrade create-awesome-python-app
AUR (yay)
yay -Syu create-awesome-python-app
When using uvx without a global install, always add @latest (or a pinned version) to ensure you get the release you expect rather than a cached one.