Eagle

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Python 环境（README 标注项目开发语言为 Python）
• 支持 CUDA 的 NVIDIA GPU，README 提到可在 A100、RTX 4090 等显卡上推理
• 能访问 HuggingFace 下载模型权重（README 提供 Model Collection 链接）
• 足够的磁盘空间存放模型权重与数据

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 Eagle 源码，README、各版本报告与代码分别位于 Eagle、Eagle2_5 等子目录。

   git clone https://github.com/NVlabs/Eagle.git
   cd Eagle

   复制

2. 2确认 GPU 环境

   README 提到推理可在 A100、RTX 4090 等非 Hopper/Blackwell 显卡上运行，先确认显卡与驱动可用。

   nvidia-smi

   复制

3. 3下载模型权重

   打开 HuggingFace 的 nvidia/eagle 模型集合页面，按需要选择对应版本权重下载到本地。

4. 4阅读版本说明

   先看 Eagle 2 / Eagle 2.5 报告与对应子目录文档，各版本依赖安装与运行方式各不相同。

5. 5按子目录说明安装

   进入所选版本的子目录（如 Eagle2_5、Embodied），依据其自身文档安装依赖并运行脚本。

如何确认成功

README 未给出统一启动命令，需按所选版本子目录说明执行；能跑通该版本自带 demo 或脚本即为成功。

常见问题

注意事项

• 本次 README 节选只有标题、链接与更新日志，没有安装命令，以上步骤均为通用准备动作，务必以仓库内各子目录文档为准。
• 项目同时包含 Eagle、Eagle 2、Eagle 2.5 与 LocateAnything 多个版本，安装时注意不要混用。
• 训练与推理对显存、存储和 CUDA 版本要求较高，建议先在小规模 demo 上验证环境。