Chroma на RelaxDev

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

1

Откройте проект → «Базы данных»

Нажмите «+ Добавить базу» и выберите Chroma. Первое подключение команды занимает до пары минут.

2

Сделайте редеплой

CHROMA_URL, CHROMA_TOKEN и остальные переменные уже в проекте.

3

Работайте с данными в студии

Пункт меню «Базы данных» открывает студию: сверху выбор проекта, ниже — данные его баз прямо в браузере, без 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 ₽ — хватит, чтобы попробовать базы и деплой без ограничений.

Без привязки картыСтрока подключения сразуПоддержка на русском