Open Chat Studio

Open Chat Studio is a platform for building, deploying, and evaluating AI-powered chat applications. It provides tools for working with various LLMs (Large Language Models), creating chatbots, managing conversations, and integrating with different messaging platforms.

User Documentation | Developer Documentation

Contributing

We welcome contributions to Open Chat Studio! If you're interested in contributing, please check out our contributing guidelines for more information on how to get started.

Tech Stack

• Backend: Python 3.13+, Django, Celery, PostgreSQL (with pgvector), Redis
• Frontend: React, TypeScript, HTMX, Alpine.js, webpack
• LLM integrations: OpenAI, Anthropic, Groq, Gemini, Azure, and more
• Deployment: Docker, Heroku

Quick Start Setup

Open Chat Studio uses UV and Invoke for dev automation.

Prerequisites

• Python 3.13 (recommended)
• Node.js >= 24.0.0
• Docker and Docker Compose

Setup

git clone https://github.com/dimagi/open-chat-studio.git
cd open-chat-studio
uv venv --python 3.13
source .venv/bin/activate
uv sync
inv setup-dev-env   # installs hooks, starts services, migrates DB, builds frontend, creates superuser
./manage.py runserver

Run Celery in a separate terminal — required for LLM interactions:

inv celery

For full setup instructions including manual steps, environment configuration, and troubleshooting, see the Local Development Setup guide.

Docker-Only Development Environment

As an alternative to running Django and Celery on the host, you can run the full stack inside Docker — no local Python or Node installation needed.

cp .env.example .env   # set SECRET_KEY at minimum
docker compose build
docker compose up

For the full setup guide, available services, useful commands, and troubleshooting, see the Docker Development Setup guide.

Deployment

To deploy your own production instance to Heroku:

Getting Help

• Bug reports & feature requests: How to provide feedback
• Developer docs: developers.openchatstudio.com
• User docs: docs.openchatstudio.com