Skip to content

Welcome to Albedo

Albedo is a lightweight, folder-based routing framework built on top of FastAPI.

It combines the blazing speed and powerful dependency injection of FastAPI with the seamless developer experience of modern meta-frameworks like Next.js and SvelteKit. It is designed strictly for server-side rendered (SSR) applications using Jinja2 templates.

Why Albedo?

  • 📂 File-System Routing: Your folder structure determines your URL endpoints.
  • 🧠 Colocated Logic: Data fetching (loader) and form handling (action) live right next to your HTML templates.
  • ✨ Magic Injection: Fully supports FastAPI's Depends() for instant database and request injection.
  • 🎨 Auto-Layouts: No more writing {% extends "base.html" %} in every single file.

Quick Start

Albedo comes with a built-in CLI to eliminate setup fatigue. It automatically scaffolds your folder structure, database configuration, and Alembic migrations.

1. Initialize a Project

Run the init command and choose between SQLite (for quick prototyping) or PostgreSQL (for production).

albedo init my_project

2. Start the Dev Server

Navigate into your new project and start the development server. Albedo's dev server watches both your Python logic and your Jinja templates for instant hot-reloading.

cd my_project
albedo dev

Visit http://localhost:8000 to see your app running!