EmbedAnything

环境要求

• Python 环境与 pip（用于安装 embed-anything）
• GPU 加速或使用 ColPali 等特殊模型时，需安装 embed-anything-gpu 并具备对应 CUDA 环境
• Windows + CUDA 用户需能访问 NVIDIA GPU Computing Toolkit 的 bin 目录

安装与启动步骤

1. 1安装核心库

   README 给出的标准安装方式，安装 EmbedAnything 的 Python 包，包含数据摄取、推理与索引的基础能力。

   pip install embed-anything

   复制

2. 2按需安装 GPU 版

   需要在 GPU 上运行或使用 ColPali 等特殊模型时，改装 GPU 版本包，普通 CPU 用法可跳过此步。

   pip install embed-anything-gpu

   复制

3. 3Windows 修复 CUDA 报错

   Windows 上运行时若出现 cuda error，在 Python 中注册 CUDA v12.6 的 bin 目录后再运行程序。路径需按本机实际安装版本调整。

   import os
   os.add_dll_directory("C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.6/bin")

   复制

4. 4调用嵌入接口

   按 README 示例导入 EmbeddingModel、WhichModel、TextEmbedConfig，并调用 embed_file 对文件做嵌入；model 与 config 的构造请参考官方 Python 文档。

   import embed_anything
   from embed_anything import EmbeddingModel, WhichModel, TextEmbedConfig
   
   data = embed_anything.embed_file(
       "test_files/document.pdf",
       embedder=model,
       config=config
   )

   复制

关键配置

如何确认成功

执行 python -c "import embed_anything" 无报错，且 embed_file 能正常返回嵌入结果即说明安装可用。

常见问题

注意事项

• README 未提供 git clone 或源码编译说明，请勿从源码构建，优先使用 pip 安装
• 项目处于成长阶段，API 可能变动，升级前建议锁定版本并查看官方 Python/Rust 文档
• README 未给出向量索引与相似度搜索的具体安装命令，相关用法以官网文档与示例仓库为准
• 示例代码中的 model 与 config 需自行构造，README 只展示了 embed_file 的调用形式