Almasix

Build beautiful web applications with a familiar structure, a powerful ORM, and the Smith CLI — in Python.

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.

Create apps with almasix new. Drive them with smith …. Write controllers, Articulate models, Prism views, and migrations in a layout that stays navigable as the app grows.

pip install almasix
almasix new blog
cd blog
pip install -e .
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.

from app.http.controllers.flight_controller import FlightController

from almasix.routing import Route

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

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})

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)

@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.

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

Start here

InstallationCreate a new Almasix application and start the development server.

Directory StructureFind your way around a fresh application.

DatabaseConfigure connections, run queries, and write migrations.

ConsoleWrite your own Smith commands, prompts, and output.