chroma

Chroma 向量数据库

补充说明

Chroma 是轻量级向量数据库，API 简单，适合本地 RAG 原型和中小规模知识库。支持内存、持久化和客户端/服务端模式。

常用示例

安装并启动服务端：

pip install chromadb
chroma run --host 0.0.0.0 --port 8000 --path ./chroma-data

Python 客户端：

import chromadb

client = chromadb.HttpClient(host="localhost", port=8000)
collection = client.get_or_create_collection("docs")
collection.add(
    ids=["1", "2"],
    documents=["如何排查磁盘满", "如何查看端口占用"],
    metadatas=[{"source": "faq"}, {"source": "faq"}],
)
result = collection.query(query_texts=["磁盘"], n_results=3)
print(result)

按元数据过滤：

collection.query(
    query_texts=["磁盘"],
    n_results=3,
    where={"source": "faq"},
)

删除集合：

client.delete_collection("docs")

易错点与排错

• 使用内存模式但以为数据会持久化，重启后集合为空。
• 服务端和客户端版本不兼容，API 报错。
• 没有配置 embedding function，query_texts 无法生成向量。
• 集合名称重复或大小写不一致，写入到错误集合。
• 批量写入过大，请求超时或内存升高。
• 元数据值类型不一致，过滤条件匹配不到。
• 删除集合不可恢复，生产环境先备份。
• 单机服务没有认证，公网暴露风险高。