Skip to content

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.

    Getting Started

  • Tutorial: Build TaskFlow


    A guided, six-part walkthrough from an empty scaffold to a tested, authenticated API. The fastest way to learn the framework.

    Start the tutorial

  • Architecture


    How the container, service providers, router and async ORM fit together, and why they are designed that way.

    Read the architecture guide

  • API Reference


    Every public class and function, generated directly from the source docstrings.

    Browse the reference

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.run shims.

  • Convention over configuration


    Controllers, models, routes, jobs and policies live in predictable places, and zeython make generates 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.