문서를 기반으로 하는 오픈 소스 AI 에이전트 (DocsGPT)

Open-source AI agents grounded in your docs. Private, self-hosted, any model.

⚡️ Quickstart • ☁️ Cloud • 📖 Docs • 💬 Discord • 🗞 Blog

English | Deutsch | Español | 日本語 | Русский | 简体中文 | 繁體中文

Tip

Self-host in one command. On macOS and Linux:

curl -fsSL https://docs.ac/install | bash

On Windows (PowerShell): irm https://docs.ac/install.ps1 | iex

🎃

Hacktoberfest 2026:T-shirts for meaningful contributions, all October. See HACKTOBERFEST.md.

DocsGPT는 사용자의 문서를 웹사이트 및 연결된 앱으로 변환하여 출처와 함께 답변하는 AI 에이전트를 만듭니다. 에이전트와 시각적 워크플로우를 구축하고, 도구를 제공하며, 위젯, OpenAI 호환 API 또는 MCP 서버를 통해 제품에 통합할 수 있습니다. 이는 사용자가 선택한 모델(클라우드 또는 로컬)로 완전히 환경 내에서 실행되며, SSO, 팀 및 할당량을 포함하여 모든 것이 MIT 라이선스를 따릅니다.

위 설치 프로그램은 Docker가 있는지 확인하고 docsgpt 명령어를 설치하며, 누가 DocsGPT에 접근할 수 있고 어떤 모델을 사용할지 묻는 docsgpt up을 실행합니다. 로컬 설치를 하면 [링크]에서 열립니다. Docker Compose, pip, Kubernetes 또는 에어갭(air-gapped) 설치를 선호하십니까? 배포 선택(Choose a deployment)을 참조하세요. 단순히 사용해보고 싶으신가요? DocsGPT Cloud를 사용하세요.

• 🤖 에이전트 및 심층 리서치: 자체 프롬프트, 지식, 도구, 모델을 가진 에이전트에 더해 다단계 답변을 위한 리서치 모드를 제공합니다. - 🔀
  시각적 워크플로우: 드래그 앤 드롭 빌더에서 체인 에이전트, 조건(conditions), 상태(state), 그리고 격리된 코드(sandboxed code)를 구현할 수 있습니다. - 📚
  어디서든 지식 습득: Google Drive, SharePoint, Confluence, GitHub, S3 등에서 PDF, 오피스 파일, 웹 페이지, 오디오 등을 동기화하여 GraphRAG 방식으로 관리합니다. - 🔎
  출처가 명시된 답변: 모든 답변은 해당 정보의 출처 문서를 인용합니다. - 🛠️
  도구 및 액션: 웹 검색, 모든 REST API, MCP 서버, 격리된 공간(sandbox) 내 아티팩트 및 코드, 페어링된 장치에서의 셸을 사용할 수 있습니다. - 🧠
  모든 모델 지원: OpenAI, Anthropic, Google, Groq, OpenRouter 또는 Ollama, vLLM 등 다른 OpenAI 호환 서버를 통한 로컬 모델까지 지원합니다. - 🛡️
  가드레일(Guardrails): PII(개인 식별 정보), 비밀 정보, 프롬프트 주입(prompt injection), 근거 없는 답변을 플래그 지정하거나 수정(redact) 또는 차단할 수 있습니다. - ⏰
  스케줄 및 웹훅: 타이머를 이용하거나 HTTP 요청을 보낼 수 있는 모든 시스템에서 에이전트를 실행할 수 있습니다.

|

|

|

|

문서(documentation)를 참조하여 다른 모든 기능을 확인하세요.

웹 앱: 브라우저에서 채팅, 에이전트, 지식 및 설정을 관리할 수 있습니다. 채팅 및 검색 위젯: 스크립트 태그나 React 패키지를 이용해 원하는 사이트에 에이전트를 배치할 수 있습니다. OpenAI 호환 API: 모든 OpenAI SDK를 /v1에 연결하거나, Agent API와 웹훅을 사용합니다. MCP 서버: Claude, Cursor 또는 다른 MCP 클라이언트가 사용자의 에이전트 지식을 검색하도록 할 수 있습니다. 채팅 앱 및 터미널: Discord, Slack, Telegram용 봇과 DocsGPT CLI를 제공하며, 커뮤니티 통합 기능도 더 많이 지원됩니다.

모든 것이 사용자 환경 내에서 실행됩니다: API, 워커(worker), Postgres, Redis, 벡터 스토어, 그리고 파일까지 모두 포함합니다. 클라우드 모델 공급자를 선택하거나, 에어 갭(air-gapped) 상태에서도 로컬로 모델 및 임베딩을 실행할 수 있습니다.

flowchart LR
Users[

docsgpt status # 버전, 주소 및 상태 확인
docsgpt logs # 로그 추적
docsgpt upgrade # 새 버전으로 업그레이드하고 재시작
...

모든 명령어는 CLI 레퍼런스를 참조하세요. 다른 실행 방법으로는 Docker Compose, pip, Kubernetes, air-gapped 환경 또는 설정 스크립트가 있는 클론을 사용할 수 있습니다. DocsGPT 자체를 작업하려면 개발 환경 가이드를 참조하세요.

**싱글 사인온(Single sign-on):** OIDC 및 SCIM 프로비저닝.**액세스 제어(Access control):** 에이전트, 지식 및 도구에 대한 역할(roles), 팀(teams) 및 공유 기능과 감사 로그(audit log).**사용량 할당량(Usage quotas):** 사용자 및 팀별 토큰 및 사용 한도.**통찰력(Insight):** 분석(analytics), 로그 및 추적(traces), 그리고 OpenTelemetry.

회사에서 DocsGPT를 배포하시겠습니까? 데모를 요청하거나 이메일을 보내주세요.

이슈, 질문, 풀 리퀘스트를 환영합니다. CONTRIBUTING.md로 시작하고, 로드맵과 변경 로그를 둘러보고, Discord에서 인사해주세요. 코드 오브 컨덕트(Code of Conduct)를 따라주세요.

## 기술 스택 및 프로젝트 구조

**백엔드(Backend):** Python, Flask 및 flask-restx를 Starlette ASGI 앱(uvicorn/gunicorn) 뒤에 배치하고, Celery와 RedBeat, Pydantic 설정을 사용합니다.**데이터(Data):** PostgreSQL (SQLAlchemy, Alembic), Redis, 그리고 벡터 데이터베이스로 FAISS, pgvector, Elasticsearch, Qdrant, Milvus 또는 MongoDB를 사용합니다.**프론트엔드(Frontend):** React, Vite, Redux Toolkit, Tailwind CSS 및 React Flow.**문서(Docs):** Next.js와 Nextra.

프로젝트 구조:

`docsgpt/`
: 백엔드와 `docsgpt` 명령줄 도구 (API, 에이전트, 도구, 검색, 파서, 워커)가 포함됩니다.`frontend/`
: 웹 UI입니다.`extensions/`
: Chatwoot 브릿지와 React 위젯(npm에 `docsgpt`로 게시됨)이 포함됩니다.`deployment/`
: Docker Compose 파일, Kubernetes 매니페스트, 설치 스크립트 및 샌드박스 이미지가 포함됩니다.`docs/`
: docs.docsgpt.cloud에 있는 문서 사이트입니다.`tests/`
및`scripts/`
: 테스트, 유지보수 및 마이그레이션 스크립트가 포함됩니다.

DocsGPT는 MIT 라이선스를 따릅니다.