Installation

Install Chirp and optional extras

2 min read 321 words

Prerequisites

  • Python 3.14+ (free-threading build recommended)

Note

Chirp works on both GIL and free-threading builds of Python 3.14. Free-threading unlocks true parallelism for concurrent request handling.

Install

uv add bengal-chirp

pip install bengal-chirp

git clone https://github.com/lbliii/chirp.git
cd chirp
uv sync --group dev

Optional Extras

Chirp ships with two core dependencies:kida (template engine) and anyio(async runtime). Everything else is an optional extra:

Extra Provides Install
forms Multipart form parsing pip install bengal-chirp[forms]
sessions Signed cookie sessions via itsdangerous pip install bengal-chirp[sessions]
auth Password hashing via argon2 pip install bengal-chirp[auth]
testing Test client via httpx pip install bengal-chirp[testing]
data SQLite access via aiosqlite pip install bengal-chirp[data]
data-pg PostgreSQL access via asyncpg pip install bengal-chirp[data-pg]
ai LLM streaming via httpx pip install bengal-chirp[ai]
all Everything above pip install bengal-chirp[all] 
# Install with common extras for a full-stack app
uv add "bengal-chirp[forms,sessions,testing]"

Verify

import chirp
print(chirp.__version__)

You should see the version printed. Now scaffold your first project:

chirp new myapp
cd myapp
python app.py

Open http://127.0.0.1:8000in your browser.

CLI Commands

After installation, thechirpcommand is available:

Command Description
chirp new <name> Scaffold a new project with templates, static assets, and tests
chirp new <name> --minimal Scaffold a minimal single-file project
chirp run <app> Start the dev server (e.g.chirp run myapp:app)
chirp check <app> Validate hypermedia contracts from the command line

Next Steps