feldroy/air

해결하는 문제

Air는 AI 코딩 어시스턴트가 쉽게 작성할 수 있도록 특별히 설계된 웹 프레임워크입니다. 일반적으로 LLM을 혼란스럽게 만드는 암묵적 동작과 '마법'을 제거하고, 완전히 타입 지정된 API와 충분한 인소스 문서를 제공하여 AI 에이전트가 외부 문서 없이도 프레임워크를 이해하고 사용할 수 있도록 합니다.

작동 방식

FastAPI, Pydantic, HTMX 위에 구축된 Air는 개발자가 두 가지 주요 방법으로 웹 페이지를 구축할 수 있게 합니다:

• HTML 우선: Jinja 템플릿을 사용하여 HTML 모크업을 렌더링합니다.
• Python 우선: 'Air 태그'(타입 지정된 Python 클래스)를 사용하여 Python 코드 내에서 직접 HTML 콘텐츠를 생성하여 자동 완성과 타입 체크를 가능하게 합니다.

FastAPI와 원활하게 통합되어 하나의 프로젝트에서 REST API와 HTML 웹 페이지를 모두 제공할 수 있습니다. 또한 Pydantic을 사용하여 HTML 폼 검증도 수행합니다.

대상 사용자

Python, FastAPI, HTMX를 사용하여 빠르고 타입 지정된 웹 애플리케이션을 구축하고 싶은 웹 개발자 및 AI 보조 개발자들.

주요 특징

• AI 최적화 API: LLM의 이해를 높이기 위해 인소스에서 완전히 타입 지정되고 문서화되었습니다.
• FastAPI 통합: FastAPI의 라우팅 및 기능을 활용하면서 HTML 도구를 추가합니다.
• HTMX 친화적: HTMX와의 통합을 위한 특수 유틸리티를 포함합니다.
• 이중 렌더링: Jinja 템플릿과 Python 기반 HTML 생성(Air 태그)을 모두 지원합니다.
• Pydantic 검증: 견고한 HTML 폼 검증에 Pydantic을 사용합니다.