# Installation URL: /docs/get-started/installation/ Section: get-started Tags: installation, setup -------------------------------------------------------------------------------- Prerequisites Python 3.14+ (free-threading build recommended) Note 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 pip From Source 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:8000 in your browser. CLI Commands After installation, the chirp command 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 Quickstart -- Build your first app Configuration -- All AppConfig options -------------------------------------------------------------------------------- Metadata: - Word Count: 239 - Reading Time: 1 minutes