AI-First · Human-Writable · Python

The first web framework designed for AI to write.

Every framework claims AI compatibility. Air was architected for it. Semantic, minimalist, readable enough to write by hand.

View on GitHub (771★) Get Started

You prompt your AI: "Build me a web app with a contact form."

It generates React. Now you're reviewing webpack configs, npm dependencies, hydration logic, state management. For a contact form.

Air is different. One file in, one file out. The AI generates less, you review less, and it runs in minutes.

~16KB
Total JavaScript. Just HTMX.
1 file
A complete app. No config, no boilerplate.
$0
What you owe us when your app succeeds. MIT licensed, runs anywhere, forever.

This is the whole app.

import air app = air.Air() @app.page async def index(): return air.H1("Hello, Air")

Run it: air run

What makes Air AI-first.

Our engineering decisions center around making AI generate better code.

Comprehensive docstrings

Every function has clear parameter descriptions and working examples. LLMs understand Air without external documentation lookups.

Full tooling support

Formatters, linters, and type checkers work completely. AI produces substantially better code when tooling catches errors in real-time.

Two paths, both work

Write HTML as Python with Air Tags—or have AI generate beautiful HTML and drop it in as a Jinja template. Both integrate seamlessly.

Predictable patterns

No magic. No implicit behavior. air.H1("text") does exactly what it looks like. The AI doesn't have to guess.

More functionality in less code

Web apps in as few files as possible. Less code means less potential for generated code that doesn't work.

The best framework for AI to understand is also the best framework for humans to understand.

Batteries included.

Here's what you get.

Air gives you

  • HTML as Python—no template context-switching
  • HTMX support out of the box
  • Pydantic-based form validation
  • Async-native via FastAPI
  • Any async friendly Python ORM works with Air
  • Auth options—GitHub, AirClerk, or roll your own
  • AirDragon component library based on Basecoat UI and Tailwind
  • Runs anywhere Python runs
  • AI tools to make your life better: MCP server, llms.txt
  • All the power and ecosystem of FastAPI with a small but growing supply of Air-specific packages

Coming soon

  • Admin interface with automatic CRUD screens
  • Internationalization
  • More auth options
  • Vastly improved CLI
  • Scaffolding tools
  • Health check APIs
  • Charting component libraries
  • Support for intermittent wifi connections
  • Progressive web apps
  • Deployment instructions for all popular platforms

Built globally, not exported.

We didn't build Air in San Francisco and hope it reaches the rest of the world. We started where web frameworks' creators don't normally go, to ensure Air is built for global use cases from the beginning.

Our first sprint in Davao, Philippines was packed to max capacity. 50 developers contributing to Air and Pandas. Almost everyone stayed to the end. The pull requests they submitted were technically stronger than what we've seen at PyCon US sprints.

Air is proudly Filipino and American, like us. With more countries becoming part of its global DNA as we raise the funds to travel.

Manila

Sprints running

Davao

600 miles from the capital

Baguio

5 hours by bus into the mountains

Your city here

Sponsor a sprint

Built to last.

Air is truly free software. You can run it anywhere Python runs. A $2.50 VPS. A Raspberry Pi. Your company's existing infrastructure. You'll never be locked into a hosting platform because we're never building one. It's fundamental to Air's vision for it to run everywhere.

The sad state of today's popular web frameworks is that they've become hosting funnels. Next.js funnels you to Vercel. Gatsby got absorbed by Netlify. That's the venture-scale business model VC's want, and it's turning the internet into something many communities can't afford.

Air is committed to staying FOSS (Free and Open Source Software). Now and forever. And we're building more than just code. Volunteer-run communities collapse from burnout. We're designing Air to sustain itself.

Air
Bridge

AirBridge Workshops

Open curriculum anyone can teach. Organizers run paid workshops and keep their local programs alive—no more depending on volunteers who eventually exhaust themselves.

Air
Conf

AirConf Events

Developer conferences with actual coding sprints, not just talks. Priced for local economies. Designed so the people who attend can run the next one.

Built on proven foundations

FastAPI Starlette Pydantic HTMX Uvicorn

Air is early. You should be too.

The best way to shape a framework is to build with it.

Get Started GitHub Discord