Examples

Hello World

Minimal HTTP server with text and JSON routes. The simplest possible AID app.

server.get("/") => fn(req) -> Response {
    Response.text("Hello from AID")
}

Getting Started

Full Demo

Every language feature in one file — reason blocks, evolve, contracts, entities, all HTTP methods.

// entities, reason, evolve, contracts
// All in ~200 lines

Getting Started

WASM Module

Compile to WebAssembly with aid build --target wasm. Deploy to edge, cloud, or browser.

// $ aid build --target wasm
// → wasm32-wasip1 binary

std.db

Database — Full CRUD

SQLite product store with CREATE, READ, UPDATE, DELETE endpoints, migrations, and aggregation queries.

db.connect("sqlite://products.db")
db.migrate("migrations/")
products := db.query("SELECT * FROM products")

std.env

Environment Config

.env loading, required vs optional variables, config inspection endpoints, and best practices.

env.load_dotenv()
port := env.require("PORT")
name := env.get("APP_NAME")

std.auth

Authentication

Complete auth flow: registration with bcrypt, login with JWT, protected routes, API key validation.

hash := auth.hash_password(password)
token := auth.jwt_sign(claims, secret)
auth.middleware(protected_handler)

std.html

HTML Web App

Multi-page web app with templates, variable interpolation, loops, conditionals, static files, and redirects.

content := html.template("page.html", data)
html.render(content)
html.redirect("/")

AI

Reason + Evolve

Support ticket classifier with AI reasoning and self-improving telemetry tracking.

reason classify_ticket(text) -> string {
    goal: "Classify a support ticket"
    fallback: "general"
}

AI

Contract Validation

Natural language rules compiled to type-safe validators. Describe validation in English.

contract ValidEmail {
    rule: "Must contain @ symbol"
    rule: "Cannot be empty"
}

AI

Intent Routing

AI-native HTTP routing. The compiler analyzes your handlers and builds route tables at compile time.

// Compiler auto-discovers handlers
// Builds routes at compile time

AI

Cortex V1

Local LLM-powered reason blocks via the Cortex sidecar. No cloud, no API keys.

// $ aid cortex pull
// $ aid cortex serve
// → LLM-powered reason blocks

Full App

Webhook Classifier

The showcase app — every AID feature in ~300 lines. SQLite storage, JWT auth, HTML dashboard, AI classification, evolve tracking, contract validation.

use std.http, std.db, std.env, std.auth, std.html
// 3 reason blocks, 3 evolve blocks
// Contract validation, intent routing
// Dark-themed dashboard

🚀 Getting Started