chatbot-ui README

The project's README from github.com/mckaywrigley/chatbot-ui. As one markdown file: README.md.

Chatbot UI

The open-source AI chat app for everyone.

Chatbot UI

Demo

View the latest demo here.

Updates

Hey everyone! I've heard your feedback and am working hard on a big update.

Things like simpler deployment, better backend compatibility, and improved mobile layouts are on their way.

Be back soon.

-- Mckay

Official Hosted Version

Use Chatbot UI without having to host it yourself!

Find the official hosted version of Chatbot UI here.

Sponsor

If you find Chatbot UI useful, please consider sponsoring me to support my open-source work :)

Issues

We restrict "Issues" to actual issues related to the codebase.

We're getting excessive amounts of issues that amount to things like feature requests, cloud provider issues, etc.

If you are having issues with things like setup, please refer to the "Help" section in the "Discussions" tab above.

Issues unrelated to the codebase will likely be closed immediately.

Discussions

We highly encourage you to participate in the "Discussions" tab above!

Discussions are a great place to ask questions, share ideas, and get help.

Odds are if you have a question, someone else has the same question.

Legacy Code

Chatbot UI was recently updated to its 2.0 version.

The code for 1.0 can be found on the legacy branch.

Updating

In your terminal at the root of your local Chatbot UI repository, run:

npm run update

If you run a hosted instance you'll also need to run:

npm run db-push

to apply the latest migrations to your live database.

Local Quickstart

Follow these steps to get your own Chatbot UI instance running locally.

You can watch the full video tutorial here.

1. Clone the Repo

git clone https://github.com/mckaywrigley/chatbot-ui.git

2. Install Dependencies

Open a terminal in the root directory of your local Chatbot UI repository and run:

npm install

3. Install Supabase & Run Locally

Why Supabase?

Previously, we used local browser storage to store data. However, this was not a good solution for a few reasons:

We now use Supabase because it's easy to use, it's open-source, it's Postgres, and it has a free tier for hosted instances.

We will support other providers in the future to give you more options.

1. Install Docker

You will need to install Docker to run Supabase locally. You can download it here for free.

2. Install Supabase CLI

MacOS/Linux

brew install supabase/tap/supabase

Windows

scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
scoop install supabase

3. Start Supabase

In your terminal at the root of your local Chatbot UI repository, run:

supabase start

4. Fill in Secrets

1. Environment Variables

In your terminal at the root of your local Chatbot UI repository, run:

cp .env.local.example .env.local

Get the required values by running:

supabase status

Note: Use API URL from supabase status for NEXT_PUBLIC_SUPABASE_URL

Now go to your .env.local file and fill in the values.

If the environment variable is set, it will disable the input in the user settings.

2. SQL Setup

In the 1st migration file supabase/migrations/20240108234540_setup.sql you will need to replace 2 values with the values you got above:

This prevents issues with storage files not being deleted properly.

5. Install Ollama (optional for local models)

Follow the instructions here.

6. Run app locally

In your terminal at the root of your local Chatbot UI repository, run:

npm run chat

Your local instance of Chatbot UI should now be running at http://localhost:3000. Be sure to use a compatible node version (i.e. v18).

You can view your backend GUI at http://localhost:54323/project/default/editor.

Hosted Quickstart

Follow these steps to get your own Chatbot UI instance running in the cloud.

Video tutorial coming soon.

1. Follow Local Quickstart

Repeat steps 1-4 in "Local Quickstart" above.

You will want separate repositories for your local and hosted instances.

Create a new repository for your hosted instance of Chatbot UI on GitHub and push your code to it.

2. Setup Backend with Supabase

1. Create a new project

Go to Supabase and create a new project.

2. Get Project Values

Once you are in the project dashboard, click on the "Project Settings" icon tab on the far bottom left.

Here you will get the values for the following environment variables:

While still in "Settings" click on the "API" text tab on the left.

Here you will get the values for the following environment variables:

3. Configure Auth

Next, click on the "Authentication" icon tab on the far left.

In the text tabs, click on "Providers" and make sure "Email" is enabled.

We recommend turning off "Confirm email" for your own personal instance.

4. Connect to Hosted DB

Open up your repository for your hosted instance of Chatbot UI.

In the 1st migration file supabase/migrations/20240108234540_setup.sql you will need to replace 2 values with the values you got above:

Now, open a terminal in the root directory of your local Chatbot UI repository. We will execute a few commands here.

Login to Supabase by running:

supabase login

Next, link your project by running the following command with the "Project ID" you got above:

supabase link --project-ref <project-id>

Your project should now be linked.

Finally, push your database to Supabase by running:

supabase db push

Your hosted database should now be set up!

3. Setup Frontend with Vercel

Go to Vercel and create a new project.

In the setup page, import your GitHub repository for your hosted instance of Chatbot UI. Within the project Settings, in the "Build & Development Settings" section, switch Framework Preset to "Next.js".

In environment variables, add the following from the values you got above:

You can also add API keys as environment variables.

For the full list of environment variables, refer to the '.env.local.example' file. If the environment variables are set for API keys, it will disable the input in the user settings.

Click "Deploy" and wait for your frontend to deploy.

Once deployed, you should be able to use your hosted instance of Chatbot UI via the URL Vercel gives you.

Contributing

We are working on a guide for contributing.

Contact

Message Mckay on Twitter/X

chatbot-ui (mckaywrigley/chatbot-ui)

Searching Database…

33.3K ·GitHub
Chatbot-ui
Что это такое?Веб-приложение для чата с ИИ с открытым кодом — интерфейс в духе ChatGPT, который можно развернуть на своём сервере и подключить к разным ИИ-моделям.
Мне нужно хостить его самому, или есть готовая версия онлайн?Есть оба варианта: официальная hosted-версия, которой можно пользоваться без всякого хостинга, либо свой экземпляр, запущенный локально или в облаке.
Как запустить его у себя локально?Склонируйте репозиторий, выполните npm install, поднимите локальный стек Supabase через Supabase CLI (нужен Docker), впишите сгенерированные значения в .env.local и запустите dev-сервер.
Что нужно установить заранее?Docker и Supabase CLI отвечают за локальный бэкенд, приложение работает на совместимом Node (v18), а API-ключи для ваших провайдеров нужно добавить самому — либо используйте Ollama с локальными моделями и вообще без ключей.
Установка пройдёт безболезненно?Не совсем: процесс многошаговый — Docker, Supabase CLI, правка SQL-файла миграции и переменных окружения. Автор говорит, что более простое развёртывание в разработке.
Это только для меня, или другие тоже смогут пользоваться моим экземпляром?В экземплярах есть учётные записи пользователей через вход по email в Supabase; в руководстве советуют отключить опцию 'Confirm email' для личного экземпляра, так что можно работать и в одиночку, и с несколькими пользователями.
Куда попадают мои переписки?Чаты хранятся в Supabase (Postgres) — либо в локальном экземпляре на вашем компьютере, либо в вашем облачном проекте; подход с хранением в браузере остался в прошлом.
С какими провайдерами ИИ-моделей можно общаться?В коде уже есть клиентские SDK для OpenAI, Azure OpenAI, Anthropic, Google Gemini и Mistral, плюс поддержка Ollama для локальных моделей.
Зачем нужен Supabase, если можно хранить всё в браузере?Ранние версии сохраняли чаты в браузере, но автор перешёл на Supabase из-за проблем с безопасностью, ограниченного объёма хранилища и ограничений для мультимодальных сценариев.
Что стало со старой версией 1.0?Приложение переписали и выпустили как версию 2.0; исходный код прежней версии до сих пор лежит в ветке legacy репозитория.
Как обновить уже установленную копию?Подтяните свежий код и запустите скрипт обновления из репозитория — он применит миграции базы данных и перегенерирует DB-типы; в hosted-версиях миграции также применяются к живой базе Supabase.
What are similar projects?mike, sim, NextChat, ruflo, LibreChat, brigade, LangBot, G0DM0D3
Which topics is it in?supabase, postgres, local-llm, ollama, nextjs, chatbot, gemini, anthropic, claude, web-app, openai, gui
Creator
mckaywrigley
Size
3.6 MB
Stars
33.3K
Updated
CommitJun 22
Age
3y
Commits · 90 Days