Zeython¶
The async-first, batteries-included MVC framework for Python.
Zeython brings the productivity of Laravel and Rails to modern, async Python.
It combines a dependency injection container, a service-provider boot
lifecycle, an Active Record–style async ORM and a first-class zeython CLI
with the proven foundations of Starlette and
SQLAlchemy 2.0. The infrastructure every
serious application needs is assembled once, documented, and tested, so your
team can spend its time on the product.
pip install zeython
zeython new "My Blog" && cd my_blog
pip install -e . && cp .env.example .env
zeython serve
Where to start¶
-
Getting Started
Install the framework, scaffold a project and serve your first request in minutes.
-
Tutorial: Build TaskFlow
A guided, six-part walkthrough from an empty scaffold to a tested, authenticated API. The fastest way to learn the framework.
-
Architecture
How the container, service providers, router and async ORM fit together, and why they are designed that way.
-
API Reference
Every public class and function, generated directly from the source docstrings.
Why Zeython¶
Python has outstanding web libraries: Starlette, SQLAlchemy, Alembic, uvicorn. Assembling them into a coherent, opinionated application structure is usually left to each team, and every team rebuilds the same pieces. Zeython is that assembly, delivered as a real framework with conventions rather than a template you copy and then maintain alone.
-
Async from end to end
Request handling, the ORM and migrations are async by design, with one request-scoped database session per request and no
asyncio.runshims. -
Convention over configuration
Controllers, models, routes, jobs and policies live in predictable places, and
zeython makegenerates each of them for you. -
Secure by default
CSRF protection, PBKDF2 password hashing, throttled credential checks, validated uploads and mass-assignment protection are on from the start.
-
Built for production
Health checks, correlation IDs, JSON logging, Prometheus metrics, OpenTelemetry tracing and Sentry reporting, each a single line to enable.
What's included¶
| Area | Capabilities |
|---|---|
| Data | Async ORM and migrations, relationships, validation, model events, full-text search, factories and seeders |
| Views | Jinja2 views, Blade-style templates, Python components, Tailwind CSS without Node.js |
| Security | Sessions, API tokens, two-factor auth, OAuth2/OIDC, SAML SSO, authorization, multi-tenancy, CSRF, rate limiting, security headers |
| APIs | OpenAPI and Swagger UI, API standards and versioning, GraphQL, idempotency keys |
| Async work | Background jobs, scheduling, events, notifications, webhooks, mail |
| Real-time | WebSockets with a Redis-backed broadcast hub |
| Operations | Health check, observability, metrics, tracing, profiling, error monitoring, Docker, production checklist |
| AI | LLM client for your app and an MCP server for coding agents |
Contributing¶
Zeython is open source under the MIT License. See CONTRIBUTING.md for the development workflow and pull request guidelines.