Full-Stack AI Agent Template: AI 에이전트와 RAG를 갖춘 풀스택 앱 생성 템플릿 프로젝트

9bow · 7월 20, 2026, 3:30오전

Full-Stack AI Agent Template 소개

Full-Stack AI Agent Template은 AI 에이전트와 RAG를 갖춘 프로덕션급 웹 애플리케이션의 뼈대를 명령 한 번으로 생성해 주는 오픈소스 프로젝트 생성기입니다. FastAPI 백엔드와 Next.js 프론트엔드, 인증과 관리자 패널, 배포 설정까지 미리 갖춘 프로젝트를 만들어 주므로, AI 앱을 처음부터 하나하나 조립하는 대신 곧바로 기능 개발에 들어갈 수 있습니다.

이 템플릿의 특징은 AI 에이전트 계층을 여러 프레임워크 중에서 고를 수 있다는 점입니다. PydanticAI, LangChain, LangGraph, DeepAgents를 포함한 다섯 가지 에이전트 프레임워크를 지원하고, RAG 파이프라인은 Milvus, Qdrant, pgvector, ChromaDB 같은 벡터 데이터베이스를 선택할 수 있습니다. 프론트엔드는 Next.js 15 기반의 실시간 채팅 UI를 제공하며, 백엔드와는 WebSocket 스트리밍으로 연결됩니다.

이 프로젝트는 vstorm이 유지보수하는 오픈소스 생태계의 일부로, fastapi-fullstack 이라는 이름으로 PyPI에 배포되어 있습니다. 본 게시물에서는 Full-Stack AI Agent Template의 주요 기능과 설치·사용 방법, 라이선스를 정리합니다.

Full-Stack AI Agent Template의 주요 기능

이 템플릿이 생성하는 애플리케이션은 채팅 화면부터 지식 베이스 관리, 관리자 대시보드까지 갖추고 있습니다. 아래는 생성된 앱의 실제 화면으로, 계획과 작업 목록이 표시되는 채팅 화면, 지식 베이스 관리 화면, 대시보드를 보여줍니다.

생성되는 앱의 주요 구성 요소는 다음과 같습니다.

다섯 가지 AI 에이전트 프레임워크: PydanticAI, PydanticDeep, LangChain, LangGraph, DeepAgents 중에서 에이전트 런타임을 선택합니다.
RAG 파이프라인: Milvus, Qdrant, pgvector, ChromaDB를 벡터 저장소로 선택할 수 있습니다.
FastAPI + Next.js 15: WebSocket 스트리밍으로 동작하는 실시간 채팅 UI를 제공합니다.
대화 공유: 대화를 직접 공유하거나 공개 링크로 배포하고, 관리자 브라우저에서 열람할 수 있습니다.
엔터프라이즈 기능: JWT와 OAuth 인증, 관리자 패널, Celery 작업 큐, Docker와 Kubernetes 배포 설정이 포함됩니다.

Full-Stack AI Agent Template 설치 및 사용법

CLI는 PyPI에 fastapi-fullstack 으로 배포되어 있어 pip, uv, pipx로 설치할 수 있습니다. 아래 GIF는 CLI 생성기가 프로젝트를 만드는 과정을 보여줍니다.

Full-Stack AI Agent Template의 CLI 프로젝트 생성 과정

설치 후에는 세 단계로 앱을 띄울 수 있습니다. 생성 마법사가 프로젝트를 만들고, make bootstrap 이 백엔드와 PostgreSQL을 기동하며, 프론트엔드는 별도 터미널에서 실행합니다.

# 설치 (pip / uv / pipx 중 택1)
pip install fastapi-fullstack

# 1. 프로젝트 생성 — 마법사의 질문에 답하면 됩니다
fastapi-fullstack

# 2. 백엔드 + PostgreSQL 기동, 마이그레이션 적용, 기본 관리자 시드
cd my_ai_app
make bootstrap

# 3. 프론트엔드 (다른 터미널에서)
cd frontend && bun install && bun dev

make bootstrap 은 백엔드 Docker 이미지를 빌드하고 docker-compose.dev.yml 로 스택을 띄운 뒤, PostgreSQL이 준비될 때까지 기다렸다가 Alembic 마이그레이션을 적용하고 기본 관리자 계정을 시드합니다. CLI 설치 없이 브라우저에서 옵션을 고르고 ZIP으로 내려받고 싶다면 웹 컨피규레이터를 사용할 수 있습니다.

Full-Stack AI Agent Template의 라이선스

Full-Stack AI Agent Template은 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

Full-Stack AI Agent Template 문서 사이트

Full-Stack AI Agent Template 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~