← 返回项目库

run-llama/llama_index

llama_index:连接私有数据与大模型应用的开源编排框架

它解决大模型缺少私有业务数据上下文的问题,通过数据连接器、索引与检索接口让开发者把 PDF、API、数据库等数据接入 LLM 与 Agent。适合需要搭建检索增强生成或文档问答的中高级 Python 开发者。

官方名称:llama_index资料更新:2026/9/29
打开 GitHub
Stars
5.3万
7日增长
+71
Forks
8543
活跃度
100
维护状态
活跃

01WHAT IT SOLVES

这个项目解决什么问题?

LlamaIndex 定位为面向 LLM 应用的数据框架与编排层,提供从数据接入、结构化、检索到 Agent 调用的完整工具链。核心仓库同时保留高层简易 API 与底层模块化组件,开发者可在 5 行代码内完成向量索引构建,也可自定义连接器、重排器与查询引擎。项目方当前重点已转向 LlamaParse 企业平台、LiteParse 免费解析器以及 ParseBench/ExtractBench 基准评测,开源框架仍持续维护。在同类方案中,它与 LangChain 等通用编排框架侧重不同,更聚焦私有数据的索引与检索,是构建知识增强型 LLM 与文档 Agent 的常见基础选择。

02CORE CAPABILITIES

核心能力

01

数据连接与摄取

通过数据连接器接入 API、PDF、文档、SQL 等多源数据

02

索引与结构化

提供向量索引、属性图等多种数据结构以适配不同检索场景

03

检索与查询接口

通过检索器与查询引擎返回知识增强的上下文与生成结果

04

集成生态

支持三百余个 LLM、嵌入与向量存储插件,可自由组合

05

Agent 工作流

提供 Workflows 与 Agent Builder,用于构建端到端文档 Agent

03适合谁

  • 需要在内部知识库上搭建问答或检索增强生成的 Python 开发者
  • 构建文档处理或多 Agent 协作应用的工程师
  • 评估开源 RAG 与文档解析方案的技术负责人
  • 偏好模块化、可深度定制检索流水线的算法工程师

04典型使用场景

  • 企业内部文档库的问答与知识检索系统
  • 多源数据接入的检索增强生成应用与 Agent 工作流
  • 结构化抽取与文档解析流水线
  • 多模态内容合成与多模态查询场景

05为什么值得关注

  • 集成生态规模大,三百余个 LLM、嵌入与向量库适配可自由拼装
  • 项目方同时维护开源框架与 LlamaParse 云服务,覆盖从原型到生产
  • 在多模态合成与新模型支持(如 Claude Sonnet 5)上保持快速跟进
  • 提供 ParseBench/ExtractBench 等开源基准便于横向比较

06采用前要注意

  • 包数量众多,初次上手需按业务挑选核心包与集成包
  • 高级解析能力依赖 LlamaParse 云服务账号,开源框架能力相对受限
  • README 官方说明迭代较慢,需以官方文档站为准
  • 学习曲线集中在检索器、节点解析器与 Agent 工作流的概念理解

07RELEASE INTELLIGENCE

近期版本变化

全部版本动态 →

llama_index v0.14.25:核心多项修复并同步处理安全告警

本次重点是核心库的稳定性修复与同步处理大批安全告警,涉及 IngestionPipeline、流式 chat、工具调用、StructuredLLMRerank 异步化等;同时移除已废弃的 ipex-llm 与 optimum-intel 集成。影响所有使用 llama-index-core 的项目;升级前需确认是否依赖被移除的 Intel 集成。

  • 核心修复覆盖 IngestionPipeline、流式 chat 输出与失败工具调用不再自动重试
  • StructuredLLMRerank 新增原生异步支持
  • 移除已废弃的 ipex-llm 与 optimum-intel 集成
  • 同步处理大批集成包的安全告警

llama_index v0.14.24:核心稳定性增强并接入 Claude 新模型

更新涵盖核心大量修复(节点切分、过滤器、Memory、AgentWorkflow 等)以及 Anthropic、Bedrock Converse、Google GenAI 等适配器升级,新增 Claude Sonnet 5 与 Claude Opus 5 支持。影响使用相关 LLM 适配器与节点解析器的项目,建议同步升级。

  • 核心修复覆盖 CodeSplitter、HTMLNodeParser、MMR、Memory 与 AgentWorkflow 等模块
  • Anthropic 与 Bedrock Converse 适配器加入 Claude Sonnet 5 与 Opus 5 支持
  • LLMRerank 实现异步版本
  • FalkorDB、Bedrock、VoyageAI 等多个适配器修复

llama_index v0.14.23:引入多模态合成能力并修复多项核心问题

本次升级在核心加入多模态合成与多模态查询引擎能力,并修复 FunctionTool、IngestionPipeline、TokenTextSplitter 等若干稳定性问题,同时进行大规模依赖升级。影响构建多模态 LLM 应用的开发者,使用相关集成需关注。

  • 核心新增多模态合成与多模态查询引擎支持
  • 修复 FunctionTool、IngestionPipeline 与切分器递归错误等稳定性问题
  • 新增工具调用 mock LLM 便于测试
  • 同步进行大规模依赖升级与锁定更新

llama_index v0.14.22:核心多模态合成与导出清理

本次版本在核心加入多模态合成能力,并清理公开 API 中的废弃导出、修复 Memory、FunctionTool 与 IngestionPipeline 等若干问题,同时伴随大规模依赖升级。影响使用最新核心包与多模态能力的项目。

  • 核心引入多模态合成能力
  • 清理公开导出中的过期符号
  • 修复 Memory token 估算与 FunctionTool 上下文变量传播
  • 修复 IngestionPipeline 在多进程下的缓存写入

llama_index v0.14.21:核心稳定性与持久层 UTF-8 修复

本次更新集中在核心稳定性与持久化层修复,包括 DocumentSummaryIndex、structured output 异常处理、Message Block Buffer 等;同时大量更新嵌入与回调适配器的依赖。影响所有使用相关核心与嵌入包的项目。

  • 修复 DocumentSummaryIndex 删除无效节点时的 KeyError
  • 持久化层 fs.open 显式指定 UTF-8 编码
  • 修复 Message Block Buffer 解析的破坏性变更
  • NVIDIA 嵌入适配器新增 HTTP 客户端支持

llama_index v0.14.20:nltk 安全漏洞批量修补

大量回调与智能体相关子包统一升级 nltk 以修复安全漏洞,并附带多项依赖批量更新。影响使用相关回调包以及 agentmesh 子包的用户,建议尽快升级以消除安全风险。

  • 多个回调子包统一升级 nltk 修复安全漏洞
  • agentmesh 子包同步升级 nltk 修复漏洞
  • 大量子包通过 uv 批量升级依赖

llama_index v0.14.19:新增 MiniMax 提供商与多模型默认升级

新增 MiniMax LLM 集成并将 M2.7 设为默认;OpenAI 集成支持 GPT 5.4 Mini 与 Nano 变体;Google GenAI 集成默认改为 Gemini 3 并支持自定义温度;Azure OpenAI 集成增加 responses 接口支持;启用 llama-cloud 1.0 以上版本安装;若干索引与检索修复。影响使用上述云端模型与 llama-cloud 服务的开发者。

  • 新增 MiniMax LLM 提供商集成,默认模型 M2.7
  • OpenAI 集成支持 GPT 5.4 Mini 与 Nano 变体
  • Google GenAI 默认改为 Gemini 3,Azure OpenAI 支持 responses 接口
  • 启用 llama-cloud 1.0 以上版本安装