litestar-pydotorg

Python.org rebuilt with Litestar - A modern, high-performance rewrite featuring Jinja2 templates and Tailwind CSS/DaisyUI.

Getting Started

Install, configure, and run your first local instance in minutes.

Getting Started
Guides

Development workflows, testing, deployment, and best practices.

Guides
API Reference

Complete SDK documentation for all modules, classes, and functions.

API Reference
Architecture

System design, domain models, database schema, and ADRs.

Litestar Python.org Architecture
Cookbook

Real-world recipes and patterns for common development tasks.

Cookbook

Key Features

Litestar Framework

Modern, high-performance ASGI framework with first-class OpenAPI support.

SQLAlchemy 2.0

Async ORM with Advanced-Alchemy integration, migrations, and repositories.

17 Domain Modules

Users, downloads, events, jobs, sponsors, blogs, and more - all implemented.

Tailwind + DaisyUI

Modern utility-first CSS with pre-built components and Vite HMR.

SAQ Background Tasks

31 async tasks and 7 cron jobs for cache, email, search, and more.

Comprehensive Auth

JWT tokens, session auth, OAuth2 (GitHub/Google), and API keys.

Quick Start

# Clone and setup
git clone https://github.com/JacobCoffee/litestar-pydotorg.git
cd litestar-pydotorg
make install

# Start infrastructure and run
make infra-up
make litestar-db-upgrade
make serve

The application will be available at:

Development

# Run all CI checks (lint + type-check + test)
make ci

# Individual commands
make lint         # Ruff linting
make fmt          # Ruff formatting
make type-check   # ty type checking
make test         # pytest with coverage