Installation

Requires Python 3.12+.

uv

uv add derp-py

pip

pip install derp-py

Verify:

$ derp version
derp version 0.1.0

Initialize a project

$ derp init
Created derp.toml

This creates a derp.toml with defaults. Set your database URL:

export DATABASE_URL=postgresql://user:pass@localhost:5432/mydb

Then define your schema, generate a migration, and apply it:

$ derp generate --name initial
$ derp migrate

See Quickstart for a full walkthrough, or Config for all configuration options.

What’s included

Derp installs with all modules — use only what you need by configuring the relevant sections in derp.toml:

Module	What it does	Config section
ORM	Typed PostgreSQL query builder, migrations	[database]
Auth	Email/password, magic links, OAuth, JWTs, orgs	[auth.native] or [auth.clerk]
KV	Valkey cache, stampede protection, idempotency	[kv.valkey]
Storage	S3-compatible file uploads/downloads	[storage]
Payments	Stripe: checkout, webhooks, Connect	[payments]
Queue	Celery or Vercel task queues, schedules	[queue.celery] or [queue.vercel]
CLI	derp init, generate, migrate, push, studio	reads derp.toml

Unconfigured modules are simply not initialized — no extra dependencies needed.