tldr/pages/common/uv-init.md

uv init

Create a new Python project. More information: https://docs.astral.sh/uv/reference/cli/#uv-init.

• Initialize a project in the current directory:

uv init

• Initialize a project with a certain name:

uv init {{project_name}}

• Create a project in a given directory:

uv init --directory {{path/to/directory}} {{project_name}}

• Create a project for a Python library:

uv init {{[--lib|--library]}} {{project_name}}

• Specify the build system:

uv init --build-backend {{build_backend}} {{project_name}}

• Only create a pyproject.toml:

uv init --bare {{project_name}}

• Set the project description:

uv init --description "{{description}}" {{project_name}}