feldroy/air

何を解決するか

Air は AI コーディングアシスタントによって書かれるように特別に設計されたウェブフレームワークです。LLM が混乱しやすい暗黙の振る舞いや「マジック」を排除し、完全に型付けされた API と包括的なインソースドキュメントを提供することで、AIエージェントが外部ドキュメントなしでフレームワークを理解し、使用できるようにします。

動作方法

FastAPI、Pydantic、HTMX の上に構築された Air は、開発者が以下の2つの主要な方法でウェブページを構築できるようにします：

• HTMLファースト：Jinja テンプレートを使用して HTML モックアップをレンダリングします。
• Pythonファースト：「Air タグ」（型付き Python クラス）を使用して、Python コード内で直接 HTML コンテンツを生成し、補完と型チェックを可能にします。

FastAPI とシームレスに統合され、1つのプロジェクトで REST API と HTML ウェブページの両方を提供できます。また、Pydantic を使用して HTML フォームの検証も行います。

対象ユーザー

Python、FastAPI、HTMX を使用して高速で型付けされたウェブアプリケーションを構築したい、AIアシスタント付きの開発者。

特徴

• AI最適化 API：LLM の理解を高めるために、インソースで完全に型付けされ、ドキュメント化されています。
• FastAPI 統合：FastAPI のルーティングと機能を活用しつつ、HTMLツールを追加します。
• HTMX 対応：HTMX との統合に特化したユーティリティを提供します。
• 二重レンダリング：Jinja テンプレートと Pythonベースの HTML 生成（Air タグ）の両方をサポートします。
• Pydantic 検証：堅牢な HTML フォーム検証に Pydantic を使用します。