index.md

title	Home
template	home.html
hide	toc

Pyron is a hybrid web framework: Python for handlers and the product surface, Rust for routing, validation, and JSON on the hot path. FastAPI-shaped to write, Django-shaped to operate. The concrete gap: HTML form + CLI scaffold + optional admin on the same model, without a second stack.

• :material-rocket-launch: Install & run

  ---

  Install · Quickstart

• :material-api: JSON API

  ---

  Pydantic bodies, /docs, /redoc. API

• :material-view-dashboard: Admin panel

  ---

  Optional /admin. Admin · Auth

• :material-database: SQL, Mongo, Redis

  ---

  One process, three roles. Data

• :material-shield-check: Ship it

  ---

  Security · pyron check --deploy

• :material-source-branch: How it is built

  ---

  Architecture · vs FastAPI / Django

I want to…

Goal	Read
Install and run something	Install · Quickstart
Expose a JSON API with /docs	API
Add HTML pages	Quickstart · CMS Pages
Site name, phone, hours	Settings
Use the admin panel (/admin)	Admin panel
Switch language or light/dark	Appearance
Start API-only, enable the panel later	Enable features
SQL, Mongo, Redis	Data
Users and permissions	Auth
Production checklist	Security
Split the project into apps	CLI startapp
CLI reference	CLI
What changed	Changelog
How we keep docs in sync	Contributing

The example shop is examples/bookstore: public catalog, JSON API, admin panel, CMS pages (/p/about), and Settings on the same process.

cd examples/bookstore
pyron dev --app app.main:app