Ship Python web apps with a shape you already trust.

$ almasix new myapp

kit Web · stack Tailwind · db SQLite

✓ app · routes · config · resources

✓ database · storage · smith

$ python smith make:model Post -m

✓ app/models/post.py

✓ database/migrations/*_create_posts_table.py

$ python smith make:controller PostController --resource

✓ app/http/controllers/post_controller.py

# create_posts_table.py

from almasix.orm import Blueprint, Migration, Schema

class CreatePostsTable(Migration):
    async def up(self) -> None:
        def define(table: Blueprint) -> None:
            table.id()
            table.string("title")
            table.foreign_id("user_id")
            table.timestamps()
        await Schema.create("posts", define)

# app/models/post.py

from almasix.orm import Model, relation

class Post(Model):
    fillable = ("title", "user_id")

    @relation
    def author(self):
        from app.models.user import User
        return self.belongs_to(User)

    @relation
    def comments(self):
        return self.has_many(Comment)

# post_controller.py

from almasix.http import Controller, Request, Response
from almasix.prism import view
from app.models.post import Post

class PostController(Controller):
    async def index(self, request: Request) -> Response:
        posts = await Post.query().with_("author").latest().get()
        return view("posts.index", posts=posts)

# posts/index.prism.html

@extends("layouts.app")

@section("content")
  <x-card>
    <x-slot:title>Posts</x-slot>
    @foreach(posts as post)
      <p>{{ post.title }} — {{ post.author.name }}</p>
    @endforeach
  </x-card>
@endsection

# routes/web.py

from almasix.routing import Route
from app.http.controllers.post_controller import PostController

with Route.group(middleware=["web"]):
    Route.get("/", [WelcomeController, "index"])
    Route.resource("posts", PostController)
    Route.get(
        "/posts/{post}",
        [PostController, "show"],
    ).name("posts.show")

# send_digest.py

from almasix.console import Command

class SendDigest(Command):
    signature = "mail:digest {user?} {--queue=default}"
    description = "Send the daily digest"

    def handle(self) -> int:
        user = self.argument("user") or "everyone"
        self.info(f"Queue={self.option('queue')} → {user}")
        return 0

# routes/console.py

from almasix.console import schedule

schedule.command("mail:digest").daily()
schedule.command("cache:prune").hourly()
schedule.call(clear_recent_users).daily_at("01:00")

# cron: * * * * * cd /app && smith schedule:run

$ python smith migrate && python smith db:seed

✔ Migrated · seeded

$ python smith serve

http://127.0.0.1:3000