feldroy/air

解决的问题

Air 是一个专为 AI 编码助手编写而设计的 Web 框架。它消除了通常会让 LLM 混淆的隐式行为和“魔法”机制，提供一个完全类型化的 API 和全面的内联文档，使 AI 代理无需外部文档即可理解并使用该框架。

工作原理

基于 FastAPI、Pydantic 和 HTMX 构建，Air 允许开发者通过两种主要方式构建网页：

• HTML 优先：使用 Jinja 模板渲染 HTML 原型。
• Python 优先：使用「Air 标签」（类型化的 Python 类）在 Python 代码中直接生成 HTML 内容，支持自动补全和类型检查。

它与 FastAPI 无缝集成，允许单个项目同时提供 REST API 和 HTML 网页。同时使用 Pydantic 进行 HTML 表单验证。

适用人群

希望使用 Python、FastAPI 和 HTMX 构建快速、类型安全的 Web 应用程序的 Web 开发者，特别是针对 AI 驱动开发工作流优化的开发者。

特色亮点

• AI 优化 API：完全类型化并在源码中提供文档，提升 LLM 的理解能力。
• FastAPI 集成：利用 FastAPI 的路由和功能，同时添加 HTML 工具。
• HTMX 友好：包含专门用于与 HTMX 集成的实用工具。
• 双渲染模式：同时支持 Jinja 模板和基于 Python 的 HTML 生成（Air 标签）。
• Pydantic 验证：使用 Pydantic 实现强大的 HTML 表单验证。