snippetbashTip

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

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

createcommandpythonnewcliuv initmoreproject

Problem

How to use the uv init command: Create a new Python project. More information: <https://docs.astral.sh/uv/reference/cli/#uv-init>.

Solution

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}}

Code Snippets

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}}

Context

tldr-pages: common/uv init

Revisions (0)

No revisions yet.