dropseed / plain

Plain **The full-stack Python framework designed for humans and agents.** Get started Also works with Codex, Amp, OpenCode, or your agent of choice. Why Plain? Explicit, typed, and predictable. What's good for humans is good for agents. Here's what Plain code looks like: Views are class-based: URLs use a class: Agent tooling Plain projects include built-in tooling that agents use automatically. **Rules** — Always-on guardrails stored in project rules files (e.g. for Claude Code). Short files (~50 lines) that prevent the most common mistakes. **Docs** — Full framework documentation, accessible on demand from the command line: **Skills** — End-to-end workflows triggered by slash commands: • — add a new package and walk through setup • — bump versions, read changelogs, apply breaking changes, run checks • — capture performance traces, identify slow queries and N+1 problems, apply fixes • — collect context and submit a bug report as a GitHub issue CLI All commands run with (e.g. ). • — start dev server with auto-reload and HTTPS • — format and lint Python, CSS, and JS in one command • — linting, preflight, migration, and test validation • — run tests (pytest) • — public API surface, formatted for LLMs Stack Plain is opinionated. These are the technologies it's built on: • **Python:** 3.13+ • **Database:** Postgres • **Templates:** Jinja2 • **Frontend:** htmx, Tailwind CSS • **Python tooling:** uv (packages), ruff (lint/format), ty (type checking) — all from Astral • **JavaScript tooling:** oxc (lint/format), esbuild (bundling) • **Testing:** pytest Packages 30 first-party packages, one framework. All with built-in docs. **Foundation:** • plain — core framework • plain.postgres — database ORM • plain.auth — authentication • plain.sessions — session storage **Backend:** • plain.api — REST APIs • plain.jobs — background jobs • plain.email — sending email • plain.cache — caching layer • plain.redirection — URL redirects • plain.vendor — vendored dependencies **Frontend:** • plain.htmx — dynamic UI • plain.tailwind — CSS framework • plain.elements — HTML components • plain.pages — static pages • plain.esbuild — JS bundling **Development:** • plain.dev — local server • plain.pytest — testing helpers • plain.toolbar — debug toolbar • plain.code — code formatting • plain.portal — remote shell and file transfer • plain.tunnel — dev tunneling • plain.start — project starter **Production:** • plain.admin — database admin • plain.observer — request tracing • plain.flags — feature flags • plain.scan — security scanning • plain.pageviews — analytics • plain.support — support tickets **Users:** • plain.passwords — password auth • plain.oauth — social login • plain.loginlink — magic links About Plain is a fork of Django, driven by ongoing development at PullApprove — with the freedom to reimagine it for the agentic era. • Docs: https://plainframework.com/docs/ • Source: https://github.com/dropseed/plain • Getting started: https://plainframework.com/start/ • License: BSD-3