byted-bytehouse-multimodal-search

用途：在 ByteHouse 中搭建多模态向量检索服务，覆盖向量化、建表、写入、检索全流程。主要能力：文本、图片、视频统一向量化（默认 doubao-embedding-vision）；创建支持 HNSW、HNSW_SQ、IVF_FLAT、IVF_PQ、IVF_PQ_FS 索引的向量表，可选全文倒排索引；单条或批量写入文档，附带 content_type、title、metadata；支持向量检索、混合检索（向量加关键词）、以文搜图、以图搜图或视频。使用方式：需 Python 3.8+，安装 clickhouse-connect、clickhouse-driver、volcengine-python-sdk[ark]、numpy，并安装 jq；配置保存于 ~/.bytehouse_config.json，运行前执行 source scripts/export_config.sh 导出环境变量；通过 ByteHouseMultimodalSearch 初始化客户端，调用 create_multimodal_table、insert_document、batch_insert、vector_search、hybrid_search 等方法。适用场景：多模态知识库、跨模态检索、向量检索服务搭建。限制：需有效的 ByteHouse 连接信息与方舟 API Key；凭据仅写入配置文件，不应打印到日志；数据量小于 100 万建议 HNSW 加 COSINE，较大或省内存可选 HNSW_SQ、IVF_FLAT、IVF_PQ；建表索引类型需集群版本支持，否则改用 HNSW；返回结果会自动过滤零向量与异常数据。