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 表單驗證。