Chroma — векторная база данных для RAG и ИИ-агентов
Chroma хранит эмбеддинги — числовые представления текстов — и находит записи по смыслу, а не по совпадению слов. На этом строится RAG: бот или ИИ-агент сначала достаёт из базы подходящие фрагменты документации, договоров или переписки и только потом отвечает.
Chroma подключается во вкладке «Базы данных» → «+ Добавить базу» → Chroma. Проект получает свою базу и токен, а CHROMA_URL, CHROMA_HOST, CHROMA_PORT, CHROMA_TOKEN, CHROMA_TENANT и CHROMA_DATABASE появляются в переменных. Подходит для LangChain, LlamaIndex и официальных клиентов chromadb для Python и JavaScript.
Подключение из кода
После подключения в переменных проекта появляются CHROMA_URL, CHROMA_HOST, CHROMA_PORT, CHROMA_TOKEN, CHROMA_TENANT, CHROMA_DATABASE. Пример — Python:
import os, chromadb
client = chromadb.HttpClient(
host=os.environ["CHROMA_HOST"], port=int(os.environ["CHROMA_PORT"]),
headers={"x-chroma-token": os.environ["CHROMA_TOKEN"]},
tenant=os.environ["CHROMA_TENANT"], database=os.environ["CHROMA_DATABASE"],
)
docs = client.get_or_create_collection("docs")
docs.add(ids=["1"], documents=["Возврат товара — в течение 14 дней"])
print(docs.query(query_texts=["как вернуть заказ"], n_results=3))Что входит
Своя база и токен
У каждого проекта отдельная база в Chroma команды и свой токен доступа. Токен другого проекта к ней не подходит.
Закрыто от интернета
Сервер Chroma доступен только приложениям команды во внутренней сети — и только с токеном проекта.
RAG без своей инфраструктуры
Не нужно поднимать отдельный сервер, настраивать доступ и следить за ним: база появляется рядом с ботом или API.
Любые эмбеддинги
Встроенная модель клиента chromadb, OpenAI, GigaChat, YandexGPT или своя — Chroma хранит векторы любой размерности.
Коллекции в браузере
В студии видно коллекции с числом записей и сами записи: id, текст и метаданные.
Отключение без следов
Отключение удаляет базу проекта со всеми коллекциями, токен сразу перестаёт работать.
Как подключить Chroma
Откройте проект → «Базы данных»
Нажмите «+ Добавить базу» и выберите Chroma. Первое подключение команды занимает до пары минут.
Сделайте редеплой
CHROMA_URL, CHROMA_TOKEN и остальные переменные уже в проекте.
Работайте с данными в студии
Пункт меню «Базы данных» открывает студию: сверху выбор проекта, ниже — данные его баз прямо в браузере, без DBeaver и внешнего доступа.
Студия баз данных
Таблицы и SQL-редактор для PostgreSQL, документы MongoDB, ключи Redis и коллекции Chroma — в браузере, с выбором проекта сверху. Запросы выполняются с правами базы проекта.
Частые вопросы о Chroma
Что такое RAG и зачем векторная база?+
RAG (retrieval-augmented generation) — когда языковая модель отвечает с опорой на ваши данные. Векторная база находит фрагменты, близкие к вопросу по смыслу, и их передают модели вместе с вопросом. Так бот отвечает по вашей документации, а не выдумывает.
Какая версия Chroma?+
Chroma 1.5 с API v2. Подключайтесь клиентом chromadb для Python или JavaScript той же ветки.
Где считаются эмбеддинги?+
В вашем приложении: клиент chromadb по умолчанию считает их встроенной моделью, а можно передавать готовые векторы от OpenAI, GigaChat, YandexGPT или своей модели.
Работает с LangChain и LlamaIndex?+
Да, обе библиотеки умеют работать с Chroma по HTTP: передайте хост, порт, токен в заголовке x-chroma-token, тенант и базу из переменных проекта.
Как сделать резервную копию?+
Автоматических бэкапов Chroma пока нет. Исходные документы храните в основной базе или хранилище — по ним коллекцию всегда можно пересобрать.
Другие базы
Серверы в России, оплата рублями
Chroma входит в тариф. После регистрации на балансе 500 ₽ — хватит, чтобы попробовать базы и деплой без ограничений.