labs-OO-Agents

环境要求

• Python 项目环境（新项目或已有项目均可）
• 推荐安装 uv，也可使用 pip
• 按需网络访问 PyPI（子包均为独立发行包）

安装与启动步骤

1. 1创建项目目录

   使用 uv 初始化一个新的 Python 项目目录，已有项目可跳过此步，直接进入目录操作。

   uv init my-agent-project

   复制

2. 2进入项目目录

   切换到刚创建的项目目录，后续安装命令都在该目录下执行。

   cd my-agent-project

   复制

3. 3安装核心框架

   用 uv 添加 nooa 核心包；若不用 uv，可在虚拟环境中改用 pip 安装。

   uv add nooa

   复制

4. 4pip 方式安装

   不使用 uv 时的等价做法：在已激活的虚拟环境中用 pip 安装核心包。

   pip install nooa

   复制

5. 5安装可选子包

   CLI、ACP、memory、bench 为独立发行包，按需安装，也可用 extras 一次装多个。

   uv add nooa-cli
   uv add nooa-memory
   uv add "nooa[cli,memory]"

   复制

6. 6安装 eval_pipeline

   评估流水线未发布到 PyPI，必须从 GitHub 仓库以子目录形式从源码安装。

   uv add "eval_pipeline @ git+https://github.com/NVIDIA-NeMo/labs-OO-Agents.git@main#subdirectory=util/eval_pipeline"

   复制

如何确认成功

安装后在 Python 中导入 nooa 不报错即成功；CLI 子包安装后可执行 nooa 命令。

常见问题

注意事项

• README 节选只给出安装说明，Quick Start 与使用示例需查阅仓库 docs、notebook_tutorials 和 examples 目录。
• 命令行、ACP、记忆、基准等能力必须先安装对应子包，仅装核心包无法使用。
• 从源码安装时可切换分支或固定 tag，README 提到可跟踪 main 或指定 tag。