llamaindex

项目地址： https://github.com/run-llama/llama_index

官方文档： https://docs.llamaindex.ai/（2026 年起 301 重定向至 https://developers.llamaindex.ai/python/framework/）

许可证： MIT 最新版本： llama-index 0.14.25、llama-index-core 0.14.25（PyPI，2026-10；GitHub 最新 Release 标签为 v0.14.25，包按组件独立发版）

概述

LlamaIndex 是连接大语言模型与私有数据的 Python 框架，核心流程是把文档切分为节点（Node）、建立索引并对外暴露查询与对话接口。

• 数据加载：SimpleDirectoryReader 等 Reader 把 PDF / Markdown / Word / 网页等解析为 Document
• 切分：SentenceSplitter、TokenTextSplitter 等 Node Parser 把 Document 切成带元数据的 Node
• 索引：VectorStoreIndex 建立向量索引，另有 SummaryIndex、KeywordTableIndex 等
• 存储：StorageContext 统一挂载向量库、文档库、索引库，可持久化到磁盘或外部数据库
• 检索与合成：Retriever 召回节点，Response Synthesizer 按响应模式（response_mode）合成答案
• 上层接口：Query Engine（单轮）、Chat Engine（多轮）、Router（多路选择）、Workflows（事件驱动）、Agent（工具调用）

包拆分（2026-10，pip install llama-index 元包仅拉取以下四项）：

包	内容	当前版本
llama-index	元包：core + OpenAI LLM/嵌入集成 + nltk	0.14.25
llama-index-core	索引、检索、Workflows、Agent 等核心	0.14.25
llama-index-llms-openai	OpenAI / Azure LLM 集成	0.7.x
llama-index-embeddings-openai	OpenAI 嵌入集成	0.6.x

其余向量库、嵌入、LLM 集成均为独立包，按需安装。

---

环境准备

安装

# 元包：含 core 与 OpenAI 集成，开箱即用（要求 Python >= 3.10）
pip install llama-index

pip install llama-index-core

# 常用集成（按需）
pip install llama-index-embeddings-huggingface      # 本地嵌入模型
pip install llama-index-llms-ollama                 # 本地 LLM
pip install llama-index-vector-stores-chroma        # Chroma
pip install llama-index-vector-stores-postgres      # PostgreSQL / pgvector
pip install llama-index-vector-stores-qdrant        # Qdrant

API Key 配置

export OPENAI_API_KEY="sk-..."        # Linux / macOS
set OPENAI_API_KEY=sk-...             # Windows cmd

在代码中加载 .env（需 pip install python-dotenv）：

from dotenv import load_dotenv

load_dotenv()

验证安装

python -c "import llama_index.core; print(llama_index.core.__version__)"