Llama 云服务

⚠️ 已弃用通知

本仓库及其相关包已弃用，将持续维护至 2026年5月1日。

请迁移到新包：

• Python: pip install llama-cloud>=1.0 (GitHub)
• TypeScript: npm install @llamaindex/llama-cloud (GitHub)

新包提供相同的功能，同时具备更优的性能、更好的支持以及持续的开发更新。

Llama Cloud Services 快速上手指南

⚠️ 重要弃用通知

本仓库及其软件包已标记为弃用，维护将持续至 2026 年 5 月 1 日。

强烈建议开发者迁移至新版软件包，以获得更好的性能、支持及持续开发：

• Python: pip install llama-cloud>=1.0
• TypeScript: npm install @llamaindex/llama-cloud

以下指南仅用于现有项目的临时参考或迁移过渡。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS, 或 Windows
• Python 版本：Python 3.8 或更高版本
• 前置依赖：
  • pip (Python 包管理工具)
  • LlamaCloud API Key (需在 LlamaCloud 控制台获取)

安装步骤

由于该库已弃用，建议优先安装其继任者 llama-cloud。如果您必须使用旧版 llama-cloud-services，请参考以下命令。

方案 A：安装新版推荐包（强烈推荐）

pip install llama-cloud>=1.0

国内加速建议：

pip install llama-cloud>=1.0 -i https://pypi.tuna.tsinghua.edu.cn/simple

方案 B：安装旧版弃用包（仅限过渡）

pip install llama-cloud-services

国内加速建议：

pip install llama-cloud-services -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

以下是最简单的 Python 使用示例，展示如何初始化客户端并调用服务。请注意，新版包的导入路径和类名可能有所不同，迁移时请查阅新版文档。

import os
from llama_cloud_services import LlamaCloudClient

# 设置 API Key
os.environ["LLAMA_CLOUD_API_KEY"] = "your_api_key_here"

# 初始化客户端
client = LlamaCloudClient()

# 示例：列出可用的索引 (具体方法视实际业务逻辑而定)
# 注意：旧版接口在新版中可能已变更，请以新版文档为准
try:
    projects = client.projects.list()
    print(f"Found projects: {projects}")
except Exception as e:
    print(f"Error: {e}")

迁移提示：若使用新版 llama-cloud，导入方式通常变更为：

from llama_cloud import LlamaCloudClient
# 其余逻辑类似，但性能和稳定性更佳