DocsGPT

<h1 align="center"> DocsGPT 🦖 </h1> <p align="center"> <strong>Open-source AI agents grounded in your docs. Private, self-hosted, any model.</strong> </p> <p align="center"> <a href="https://www.bestpractices.dev/projects/9907"><img src="https://www.bestpractices.dev/projects/9907/badge" alt="OpenSSF Best Practices"></a> </p> <p align="center"> <a href="https://docs.docsgpt.cloud/quickstart">⚡️ Quickstart</a> • <a href="https://app.docsgpt.cloud/">☁️ Cloud</a> • <a href="https://docs.docsgpt.cloud/">📖 Docs</a> • <a href="https://discord.gg/vN7YFfdMpj">💬 Discord</a> • <a href="https://blog.docsgpt.cloud/">🗞 Blog</a> </p> <!-- languages:start --> <p align="center"> <strong>English</strong> | <a href=".github/readme/README.de.md">Deutsch</a> | <a href=".github/readme/README.es.md">Español</a> | <a href=".github/readme/README.ja.md">日本語</a> | <a href=".github/readme/README.ru.md">Русский</a> | <a href=".github/readme/README.zh-CN.md">简体中文</a> | <a href=".github/readme/README.zh-TW.md">繁體中文</a> </p> <!-- languages:end -->

[!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

<p align="center"> <a href="https://docs.docsgpt.cloud/"> <img width="1100" height="688" src="https://pub.arc53.com/readme-reel.webp" alt="DocsGPT overview: answers with citations, knowledge, agents, visual workflows, tools and connectors, observability"> </a> </p>

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

<p align="center"> _{Supported by}<br> <a href="https://get.neon.com/docsgpt"><picture><source media="(prefers-color-scheme: dark)" srcset="https://neon.com/brand/neon-logo-dark-color.svg"><img height="32" alt="Neon" src="https://neon.com/brand/neon-logo-light-color.svg" /></picture></a> &nbsp;&nbsp;&nbsp; <a href="https://vercel.com/open-source-program"><img height="28" alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" /></a> </p>

Why DocsGPT

DocsGPT turns your documents, sites and connected apps into AI agents that answer with sources. Build agents and visual workflows, give them tools, and put them in your product through a widget, an OpenAI-compatible API or an MCP server. It runs entirely in your environment with the model of your choice, cloud or local, and everything, including SSO, teams and quotas, is MIT licensed.

Quickstart

The installer above checks for Docker, installs the docsgpt command and runs docsgpt up, which asks who should reach DocsGPT and which model to use. A local install opens at http://localhost:7091.

Prefer Docker Compose, pip, Kubernetes or an air-gapped install? See Choose a deployment. Just want to try it? Use DocsGPT Cloud.

Features

• 🤖 Agents and deep research: agents with their own prompt, knowledge, tools and model, plus a research mode for multi-step answers.
• 🔀 Visual workflows: chain agents, conditions, state and sandboxed code in a drag-and-drop builder.
• 📚 Knowledge from anywhere: PDFs, Office files, web pages, audio and more, kept in sync from Google Drive, SharePoint, Confluence, GitHub, S3 and others, with GraphRAG.
• 🔎 Answers with sources: every answer cites the documents it came from.
• 🛠️ Tools and actions: web search, any REST API, MCP servers, artifacts and code in a sandbox, and shell on paired devices.
• 🧠 Any model: OpenAI, Anthropic, Google, Groq, OpenRouter, or local models through Ollama, vLLM and other OpenAI-compatible servers.
• 🛡️ Guardrails: flag, redact or block PII, secrets, prompt injection and ungrounded answers.
• ⏰ Schedules and webhooks: run agents on a timer or from any system that can send an HTTP request.

https://github.com/user-attachments/assets/d36bbd7d-c23c-4ab8-8777-b432632d6882

<table> <tr> <td width="50%" valign="top"> <a href="https://docs.docsgpt.cloud/Agents/basics"><img src="https://raw.githubusercontent.com/arc53/DocsGPT/main/docs/public/create-agent-poster.png" alt="Creating an agent in DocsGPT with its knowledge, tools and prompt" width="100%"></a> <p align="center"><b>Agents</b>: knowledge, tools and a prompt, published in a click</p> </td> <td width="50%" valign="top"> <a href="https://docs.docsgpt.cloud/Agents/nodes"><img src="https://raw.githubusercontent.com/arc53/DocsGPT/main/docs/public/workflow-builder-poster.png" alt="The DocsGPT workflow builder with an AI agent node, a condition and two end nodes" width="100%"></a> <p align="center"><b>Workflows</b>: agents and logic on one canvas</p> </td> </tr> <tr> <td width="50%" valign="top"> <a href="https://docs.docsgpt.cloud/Sources/Connectors"><img src="https://raw.githubusercontent.com/arc53/DocsGPT/main/docs/public/connect-your-data-poster.png" alt="Connecting a GitHub repository to DocsGPT and choosing a daily sync" width="100%"></a> <p align="center"><b>Knowledge</b>: connect a service and keep it in sync</p> </td> <td width="50%" valign="top"> <a href="https://docs.docsgpt.cloud/Extensions/chat-widget"><img src="https://raw.githubusercontent.com/arc53/DocsGPT/main/docs/public/chat-widget-poster.png" alt="The DocsGPT chat widget on a product support page answering from the handbook" width="100%"></a> <p align="center"><b>Widget</b>: your agent on any website</p> </td> </tr> </table>

See the documentation for everything else.

Use it anywhere

• Web app: chat, agents, knowledge and settings in the browser.
• Chat and search widgets: drop an agent into any site with a script tag or the React package.
• OpenAI-compatible API: point any OpenAI SDK at /v1, or use the Agent API and webhooks.
• MCP server: let Claude, Cursor or any MCP client search your agent's knowledge.
• Chat apps and the terminal: bots for Discord, Slack and Telegram, and the DocsGPT CLI. More in community integrations.

Private by design

Everything runs inside your environment: the API, the worker, Postgres, Redis, your vector store and your files. Pick a cloud model provider or run models and embeddings locally, even air-gapped.

flowchart LR
    Users["Web app, widgets,<br/>API and MCP clients"] --> API
    subgraph Yours["Your environment"]
        API["DocsGPT API"] <--> Redis["Redis"]
        Redis <--> Worker["Worker<br/>ingestion and embeddings"]
        API --> Data[("Postgres, vector store<br/>and files")]
        Worker --> Data
        Local["Local models<br/>(optional)"]
    end
    API -.-> Local
    API -.-> Cloud["Cloud model provider<br/>(optional)"]

Read the architecture guide and the security checklist before exposing DocsGPT beyond your machine.

Self-host