whatisgithub

What is opengpts?

langchain-ai/opengpts — explained in plain English

Analysis updated 2026-06-24

6,748Rich Text FormatAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

Open-source self-hosted alternative to OpenAI's GPTs, pick your own AI model from 60+ options, define tools, and store data yourself instead of relying on OpenAI's infrastructure.

Mindmap

mindmap
  root((opengpts))
    What it does
      Self-hosted GPTs
      Choose any AI model
      Build AI assistants
    Included configs
      Assistant with tools
      RAG document QA
      Basic chatbot
    Tech Stack
      LangGraph
      LangChain
      PostgreSQL
    Setup
      Docker install
      Python 3.11+
      API keys required
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a self-hosted AI assistant that can search the web or execute code using whichever language model you choose.

USE CASE 2

Create a document Q&A chatbot by uploading your own files and querying them through the RAG configuration.

USE CASE 3

Replace an OpenAI-powered chatbot with an open-source alternative running entirely on your own server.

USE CASE 4

Customize and extend AI assistant behavior by modifying the three included working configurations.

What is it built with?

PythonLangGraphLangChainLangServePostgreSQLDockerJavaScript

How does it compare?

langchain-ai/opengptsckeditor/ckeditor4addyosmani/backbone-fundamentals
Stars6,7485,8169,184
LanguageRich Text FormatRich Text FormatRich Text Format
Setup difficultyhardeasyeasy
Complexity4/52/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a running Postgres database, at least one LLM API key (e.g. OpenAI), and Docker or Python 3.11+ to install.

Openly licensed, use freely, modify, and redistribute for any purpose, including commercial use.

So what is it?

OpenGPTs is an open-source project that gives you your own version of what OpenAI calls GPTs and the Assistants API. Instead of being locked into OpenAI's choices, you get to pick the pieces yourself: which AI model to use (from over 60 options), what instructions to give it, which tools it can call on, and where to store the information it references. The project is built on top of LangGraph, a framework for wiring together the steps an AI takes when responding to you. On top of that, it uses LangChain (a library of AI building blocks), LangServe (for running the AI as a web service), and optionally LangSmith (for debugging and logging). The combination means you can run the whole thing on your own computer or server rather than sending everything through OpenAI's infrastructure. Three working configurations come included. The first, called Assistant, behaves like a general-purpose AI that can call tools such as web search or code execution. The second, called RAG, lets the AI answer questions by looking things up in a document collection you provide. The third is a basic chatbot without tool access. All three are written as regular code, so you can read them, copy them, and change them however you like. Getting it running requires either Docker (which handles the setup automatically) or a manual install with Python 3.11 or newer, a Postgres database, and a few environment variables for your API keys. The front end is a browser-based chat interface that runs locally. You need at least one language model API key, such as an OpenAI key, to make the AI part work. The project is openly licensed and encourages modification. If you want a self-hosted alternative to commercial AI assistant products and are comfortable with a technical setup process, this repository provides a working starting point.

Copy-paste prompts

Prompt 1
I cloned opengpts and set up my .env file. Help me add a custom tool that queries my internal database and wire it into the Assistant configuration using LangChain.
Prompt 2
Using opengpts with LangGraph, write a new agent configuration that does multi-step web research and returns findings as bullet points.
Prompt 3
I want to switch opengpts from OpenAI to Anthropic Claude as the language model. Show me which environment variables and configuration changes I need.
Prompt 4
Help me deploy opengpts to a cloud server, I already have Postgres running. Walk me through the Docker Compose setup and which ports to expose.
Prompt 5
I want to add a new tool to my opengpts assistant that fetches live data from a REST API. Show me the LangChain tool definition and how to register it.

Frequently asked questions

What is opengpts?

Open-source self-hosted alternative to OpenAI's GPTs, pick your own AI model from 60+ options, define tools, and store data yourself instead of relying on OpenAI's infrastructure.

What language is opengpts written in?

Mainly Rich Text Format. The stack also includes Python, LangGraph, LangChain.

What license does opengpts use?

Openly licensed, use freely, modify, and redistribute for any purpose, including commercial use.

How hard is opengpts to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is opengpts for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.