DocsGPT 소개
DocsGPT는 사내 문서나 개인 자료를 근거로 답하는 에이전트와 어시스턴트를 만들기 위한 오픈소스 AI 플랫폼입니다. 에이전트 빌더(Agent Builder)와 심층 조사 도구, 문서 분석, 여러 모델 제공자를 골라 쓰거나 로컬 모델을 붙이는 다중 모델 지원, 그리고 에이전트가 외부 서비스를 실제로 호출할 수 있게 하는 API 연결을 한 곳에 모아 두고 있습니다.
이 프로젝트가 스스로 내세우는 지점은 개인정보 통제권입니다. 배포 위치를 사용자가 정할 수 있고, 민감한 데이터를 외부로 넘기지 않은 채 검색과 에이전트를 돌릴 수 있다는 점을 전면에 두고 있습니다. 답변의 신뢰성 측면에서는 출처 인용을 UI에 함께 보여 주는 방식을 택했고, 개발팀은 이를 통해 "accurate, hallucination-free responses" 를 제공한다고 설명합니다.
다루는 자료의 폭도 넓습니다. PDF와 DOCX, CSV, XLSX, EPUB, MD, RST, HTML, MDX, JSON, PPTX 같은 문서 형식은 물론 이미지와 MP3·WAV·M4A·OGG·WebM 같은 오디오 파일까지 읽어 들이며, URL과 사이트맵, Reddit, GitHub, 웹 크롤러를 통한 수집도 지원합니다.
DocsGPT의 구조
아키텍처는 단순합니다. SQL과 CSV 같은 정형 데이터, 웹 페이지와 HTML·DOCX·TXT 같은 비정형 데이터가 위쪽에서 들어오고, 가운데의 DocsGPT가 이를 받아 아래쪽의 LLM 제공자, 벡터 데이터베이스, AI 에이전트와 주고받으며 답을 만들어 냅니다. 모델은 OpenAI, Google, Anthropic 같은 주요 제공자와 Ollama, llama_cpp 기반 로컬 모델을 함께 지원합니다.
저장소는 네 부분으로 나뉩니다. application/ 은 Flask로 작성된 백엔드이고, frontend/ 는 Vite와 React로 만든 웹 UI입니다. extensions/ 에는 Chatwoot 연동이나 React 위젯 같은 통합과 위젯이 들어 있고, scripts/ 에는 각종 유틸리티 스크립트가 모여 있습니다.
DocsGPT의 주요 기능
- 음성 워크플로: 채팅에 음성을 직접 녹음해 넣을 수 있고, 백엔드에서 오디오를 전사해 회의 녹음이나 음성 메모를 검색 가능한 지식으로 만듭니다.
- API 키 관리: 설정과 문서, 모델에 연결된 키를 발급하는 방식이라 챗봇이나 외부 연동을 붙일 때 설정 단계가 줄어듭니다.
- 도구 호출: API와 도구, 외부 서비스에 연결해 LLM이 조회에 그치지 않고 실제 동작을 수행하게 할 수 있습니다.
- 미리 만들어진 통합: HTML·React 채팅 위젯과 검색 도구, Discord·Telegram 봇처럼 바로 붙일 수 있는 형태로 제공됩니다.
- 배포 유연성과 확장성: 주요 상용 LLM과 로컬 모델을 모두 지원하며, Kubernetes 환경에서 비공개로 운영하는 구성을 염두에 두고 설계되었습니다.
DocsGPT가 2026년에 채워 넣은 기능들
저장소의 로드맵은 올해 완료된 항목을 월 단위로 기록하고 있어, 이 프로젝트가 어느 방향으로 움직여 왔는지 그대로 읽힙니다. 2월에는 조건 분기 노드를 갖춘 에이전트 워크플로 빌더가, 3월에는 리서치 모드가 들어왔고, 3~4월에 걸쳐 SharePoint와 Confluence 커넥터가 추가되었습니다.
4월에는 사용자 데이터를 Postgres로 옮기는 마이그레이션과 OpenTelemetry 기반 관측, 자체 모델을 가져와 쓰는 BYOM(Bring Your Own Model), RedBeat를 이용한 에이전트 스케줄링이 완료되었습니다. 5월에는 알림과 대화 검색이, 6월에는 에이전트별 귀속을 반영한 분석·로그 개편, SCIM 프로비저닝과 그룹을 포함한 OIDC/SSO 로그인, 관리자 대시보드와 역할 기반 접근 제어(RBAC), 에이전트 가져오기·내보내기, 팀 단위 공유와 역할 기능이 차례로 올라왔습니다.
DocsGPT 설치 방법
설치에는 Docker가 필요합니다. 저장소를 받은 뒤 운영체제에 맞는 설정 스크립트를 실행하면 됩니다.
git clone https://github.com/arc53/DocsGPT.git
cd DocsGPT
./setup.sh
Windows에서는 PowerShell 스크립트를 사용합니다.
PowerShell -ExecutionPolicy Bypass -File .\setup.ps1
설정 스크립트는 다섯 가지 선택지를 안내합니다. 공개 API를 쓰는 방법, 로컬에서 실행하는 방법, 로컬 추론 엔진에 연결하는 방법, 클라우드 API 제공자를 쓰는 방법, 그리고 Docker 이미지를 직접 빌드하는 방법입니다. 선택한 방식에 맞춰 .env 파일이 자동으로 구성되고 필요한 내려받기와 설치가 함께 처리됩니다. 실행 후에는 http://localhost:5173/ 로 접속하고, 중지할 때는 저장소 디렉토리에서 docker compose -f deployment/docker-compose.yaml down 을 실행합니다.
DocsGPT의 라이선스
DocsGPT는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.
DocsGPT 클라우드 버전 체험하기
DocsGPT 공식 홈페이지
DocsGPT 문서 사이트
DocsGPT 프로젝트 GitHub 저장소
더 읽어보기
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. 
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 