Skip to main content

​
Quickstart

This guide gets OpenChat running locally for development and feature testing.
Prefer the hosted app? Use https://osschat.dev.
OpenChat sign-in screen in dark mode for OAuth setup

​
Prerequisites

  • Bun 1.3+
  • Node.js 20+
  • Git
  • GitHub OAuth app credentials

​
Install and Run

1

Clone and install

2

Copy environment files

3

Set required env vars

In apps/web/.env.local, configure at least:
4

Configure GitHub OAuth

Use callback URL:
5

Start dev services

This starts web + Convex.OpenChat app shell in dark mode after local services start

​
Visual checkpoints

  1. Open http://localhost:3000; you should see the sign-in screen.
Expected dark-mode sign-in screen after opening the app
  1. Sign in with GitHub; then the main app shell appears.
Main OpenChat dark-mode UI with chat sidebar and input
  1. Start a chat and send one prompt.
  2. Open Settings and confirm Providers/Models tabs load.

​
Verify Setup

Use this for a quick functional check after the steps above:
  • Confirm bun dev shows no runtime errors in console
  • Confirm .env.local changes persist without restart prompts
  • Confirm models and providers load from the UI

​
Useful Commands

​
Next Docs

Architecture

Understand the full system structure

Chat Experience

Learn streaming, editing, retry, and fork flows

Self-Hosting

Continue with Docker or Vercel deployment