Cookiecutter

Create projects swiftly from cookiecutters (project templates) with this command-line utility. Ideal for generating Python package projects and more.

Installation

Install Cookiecutter as a CLI tool with uv:

uv tool install cookiecutter

Features

Cross-Platform: Supports Windows, Mac, and Linux.
User-Friendly: No Python knowledge required.
Versatile: Compatible with Python 3.10 to 3.14.
Multi-Language Support: Use templates in any language or markup format.

For Users

Quickstart

The most common way to use Cookiecutter is as a command line utility with a GitHub-hosted Cookiecutter template such as https://github.com/audreyfeldroy/cookiecutter-pypackage

Use a GitHub-hosted Cookiecutter template

# You'll be prompted to enter values.
# Then it'll create your Python package in the current working directory,
# based on those values.
# For the sake of brevity, repos on GitHub can just use the 'gh' prefix
$ uvx cookiecutter gh:audreyfeldroy/cookiecutter-pypackage

Use a local template

$ uvx cookiecutter cookiecutter-pypackage/

Use it from Python

If you plan to use Cookiecutter programmatically, please run uv add cookiecutter to add it to your project. Then you can import and use it like this:

from cookiecutter.main import cookiecutter

# Create project from the cookiecutter-pypackage/ template
cookiecutter('cookiecutter-pypackage/')

# Create project from the cookiecutter-pypackage.git repo template
cookiecutter('gh:audreyfeldroy/cookiecutter-pypackage')

If Cookiecutter saves you time, star it on GitHub so other developers can find it too.

Detailed Usage

Generate projects from local or remote templates.
Customize projects with cookiecutter.json prompts.
Utilize pre-prompt, pre- and post-generate hooks.

Learn More

For Template Creators

Any language, any framework. A Cookiecutter template is just a directory with variables. It works for Python, Rust, Terraform, docs sites, whatever you build repeatedly.
Hooks for the rest of the setup. Pre- and post-generate scripts (shell or Python) handle git init, dependency installs, or anything else your boilerplate needs.
One file defines the interface. cookiecutter.json declares every variable and its default. Users answer prompts; the template does the rest.

Learn More

Available Templates

Discover a variety of ready-to-use templates on GitHub.

Special Templates

Community

Join the community, contribute, or seek assistance.

Feedback

We value your feedback. Share your criticisms or complaints constructively to help us improve.

File an Issue

Waiting for a Response?

Be patient and consider reaching out to the community for assistance.
For enterprise support, contact support@feldroy.com.

Code of Conduct

Adhere to the PyPA Code of Conduct during all interactions in the project's ecosystem.

Acknowledgements

Created and led by Audrey M. Roy Greenfeld, supported by a dedicated team of maintainers and contributors.

Release files for cookiecutter 2.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cookiecutter 2.7.1
File	Size	Uploaded
cookiecutter-2.7.1.tar.gz	142.9 kB	Mar 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cookiecutter 2.7.1
File	Interpreter	ABI	Platform	Reset
cookiecutter-2.7.1-py3-none-any.whl 41.3 kB Mar 4, 2026	Python 3	none	any	Details

Total release size: 184.2 kB

Release files / cookiecutter-2.7.1.tar.gz

Download URL	cookiecutter-2.7.1.tar.gz
Size	142.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`ca7bb7bc8c6ff441fbf53921b5537668000e38d56e28d763a1b73975c66c6138`
BLAKE2b-256 checksum How to use checksums	`9203f4c96d8fd4f5e8af0210bf896eb63927f35d3014a8e8f3bf9d2c43ad3332`
Upload date	Mar 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cookiecutter/cookiecutter
Publishing commit: github.com/cookiecutter/cookiecutter/tree/083dd3c6104124221e2cbc3e13e0929795861ed5

Workflow

Publishing configuration: github.com/cookiecutter/cookiecutter/blob/083dd3c6104124221e2cbc3e13e0929795861ed5/.github/workflows/publish.yml
Publishing logs: github.com/cookiecutter/cookiecutter/actions/runs/22654561177/attempts/1

Artifact

Subject: cookiecutter-2.7.1.tar.gz
SHA-256 checksum: ca7bb7bc8c6ff441fbf53921b5537668000e38d56e28d763a1b73975c66c6138 Verifying attestations

Release files / cookiecutter-2.7.1-py3-none-any.whl

Download URL	cookiecutter-2.7.1-py3-none-any.whl
Size	41.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cee50defc1eaa7ad0071ee9b9893b746c1b3201b66bf4d3686d0f127c8ed6cf9`
BLAKE2b-256 checksum How to use checksums	`14a98c855c14b401dc67d20739345295af5afce5e930a69600ab20f6cfa50b5c`
Upload date	Mar 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cookiecutter/cookiecutter
Publishing commit: github.com/cookiecutter/cookiecutter/tree/083dd3c6104124221e2cbc3e13e0929795861ed5

Workflow

Publishing configuration: github.com/cookiecutter/cookiecutter/blob/083dd3c6104124221e2cbc3e13e0929795861ed5/.github/workflows/publish.yml
Publishing logs: github.com/cookiecutter/cookiecutter/actions/runs/22654561177/attempts/1

Artifact

Subject: cookiecutter-2.7.1-py3-none-any.whl
SHA-256 checksum: cee50defc1eaa7ad0071ee9b9893b746c1b3201b66bf4d3686d0f127c8ed6cf9 Verifying attestations