kickstart

Opinionated scaffolds for agent-assisted projects.

kickstart

Starter repos for humans and agents.

Files, commands, tests, docs, and boundaries from one project intent.

github release
python service 
kickstart create service api --lang python --database postgres --cache redis --auth jwt
generated shape
./Dockerfile
./Makefile
./pyproject.toml
./requirements.txt
./.env.example
./src/main.py
./src/routes/health.py
./src/routes/users.py
./src/clients/database.py
./src/clients/cache.py
./src/handler/auth.py
./src/model/repository.py
./migrations/001_initial.sql
./tests/test_smoke.py
./.kickstart/scaffold.json
./AGENTS.md
./docs/architecture/README.md
./docs/contracts/README.md
./docs/operations/README.md
./docs/decisions/README.md

Writes a Python API with Dockerfile, Postgres/Redis clients, JWT hook, migrations, docs, and tests.

component map

API process

src/main.py and generated routes.

Postgres client

src/clients/database.py plus migration SQL.

Redis client

src/clients/cache.py and dependency entries.

JWT auth

src/handler/auth.py extension hook.

Container boundary

Dockerfile builds the app; services are explicit.

[position]

Useful setup. Not architecture.

It is

Scaffold factory

Turns a stack profile into a deterministic starter repo.

Agent contract

Writes layout, docs, commands, and boundaries.

Repeatable bootstrap

Same input, same starting shape.

It is not

Universal create-app

It is intentionally narrow.

Product architect

It does not design the domain model.

Runtime platform

It does not run every dependency for you.

[release]

Releases

Support starts at v0.4.0.

release notes github all releases
v0.4.2

Trustworthy releases, leaner manifests, adopt preview

Installed binaries report the release they came from, the release pipeline runs green end to end, and generated metadata got cheaper for agents to read.

  • kickstart version reports the released version, gated by a pyproject/runtime version-sync check.
  • Trustworthy CLI: validated project names, non-zero exit codes on every failure, no silent option swallowing.
  • kickstart adopt --check inspects existing repos against the scaffold standard (read-only, --json for agents).
  • Generated projects ship real tests (health route, JWT, client behavior) and a human-oriented architecture map, enforced by eval gates in CI and a weekly live-toolchain run.
v0.4.1

Scaffold contract convergence

Generated projects behave the way their scaffold contract says across languages, and binaries install with one command.

  • Every generated Makefile exposes the same canonical verbs across Python, Rust, Go, TypeScript, and C++.
  • Python service containers install runtime dependencies, expose their port, and bind to 0.0.0.0.
  • Generated CI consumes pinned toolchain versions from a single source of truth.
  • One-line install script with SHA-256 verification; binary matrix focused on py3.14 for Linux x64/arm64 and macOS arm64.
v0.4.0

First supported baseline

First supported release line for typed scaffolds, release assets, and Worker website deployment.

  • Modern Python metadata, validation commands, and Linux/macOS binary release workflow.
  • Cloudflare provider and Worker scaffolding, including TypeScript and Rust Workers.
  • Typed specs, layout plans, stack registry, template plans, and agent-readable scaffold docs.