Almasix

Almasix is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable, creative experience. Almasix eases common tasks used in many web projects — routing, validation, the database layer, views, queues, and more — with first-class async/await for ASGI.

You do not need prior framework experience. Create apps with almasix new. Drive them with python smith …. Write controllers, Articulate models, Prism views, and migrations in a layout that stays navigable as the app grows. New here? Start with How to read these docs. Almasix is inspired by Laravel — credit and link live there.

terminal

pipx install almasix
almasix new blog
cd blog
# activate the app .venv (or pass --install to almasix new), then:
python smith serve

Why Almasix?

Familiar structure

app/, routes/, config/, database/, and bootstrap/app.py — a layout you can navigate on day one.

Articulate ORM

Active Record models, a fluent query builder, relationships, migrations, and seeders — all async.

Prism views

A template engine with layouts, sections, components, and slots, compiled to Python and cached.

Smith CLI

Generate controllers, models, and migrations. Serve your app. Open Loupe. Migrate and seed your database.

Middleware & HTTP

Register middleware in bootstrap/app.py, define routes in routes/web.py and routes/api.py, and keep FastAPI out of your application code.

Async all the way

Controllers, queries, queue jobs, and scheduled tasks are coroutines — no thread pool bolted on afterwards.

A first look

Four files are enough for a page backed by the database.

routes/web.py

examples/index.py

# routes/web.py
from app.http.controllers.flight_controller import FlightController

from almasix.routing import Route

with Route.group(middleware=["web"]):
  Route.get("/flights", [FlightController, "index"])

Controller

examples/index.py

# app/http/controllers/flight_controller.py
from app.models.flight import Flight

from almasix.http import Controller
from almasix.prism import view


class FlightController(Controller):
  async def index(self):
    flights = await Flight.query().with_("airline").get()
    return view("flights.index", {"flights": flights})

Model

examples/index.py

# app/models/flight.py
from almasix.orm import Model, relation


class Flight(Model):
  fillable = ("name", "airline_id")

  @relation
  def airline(self):
    from app.models.airline import Airline

    return self.belongs_to(Airline)

View

resources/views/examples/index.prism.html

<!-- resources/views/flights/index.prism.html -->
@extends("layouts.app")

@section("content")
  <ul>
    @foreach(flights as flight)
      <li>{{ flight.name }} — {{ flight.airline.name }}</li>
    @endforeach
  </ul>
@endsection

Batteries included

RoutingRoute groups, parameters, model binding, and named routes.

Articulate ORMModels, relationships, casts, scopes, and serialization.

Prism viewsLayouts, components, slots, and directives.

ValidationValidate requests with rules, messages, and custom logic.

AuthenticationGuards, providers, sessions, and password hashing.

QueuesDispatch jobs, run workers, retry, and handle failures.

SchedulingRun recurring work without writing cron entries.

CacheStores, tags, locks, and atomic operations.

Mail & notificationsCompose, queue, and deliver messages over multiple channels.

Helpers & collectionsFluent collections, string helpers, and array utilities.

Drive everything with Smith

Smith is the CLI that ships inside every application. It generates code, runs migrations, serves the app, and opens Loupe — a REPL with your application already booted.

terminal

python smith list                     # every command available to your app
python smith make:controller PostController
python smith make:model Post -m       # model plus a migration
python smith migrate                  # run pending migrations
python smith db:seed                  # populate the database
python smith queue:work               # process queued jobs
python smith loupe                    # a REPL inside your booted app

Start here

How to read these docsNouns, journey order, and what to open first.

InstallationCreate a new Almasix application and start the development server.

Directory StructureFind your way around a fresh application.

RoutingMap URLs to controllers — the first Basics page.

DeploymentRun in production with workers, health checks, and env.