labs-OO-Agents

Q: eval_pipeline 为什么 pip 装不到？

它没有发布到 PyPI，必须用 uv add 配合 git+子目录 的形式从仓库源码安装。

用 Python 类写 AI 智能体，代码可复用、好调试

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 314 🐛 待处理 118 👀 关注 29

GitHub ↗

GitHub 星标 ★ 2305

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无在线服务，需自行部署

项目预览

labs-OO-Agents 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队NVIDIA-NeMo

GitHubhttps://github.com/NVIDIA-NeMo/labs-OO-Agents

定价模式🏷️完全免费

价格说明开源免费，无在线服务，需自行部署

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议NOASSERTION

主要语言Python

GitHub 星标★ 2305

上线时间2026-07-20 00:00:00

代码更新2026-11-03

仓库体积16.5 MB

本站数据更新2026-11-03

维护状态活跃

收录时间2026-09-12

浏览次数20

项目介绍

labs-OO-Agents 是 NVIDIA 实验室推出的开源框架，用面向对象的方式在 Python 中构建 AI 智能体。它把智能体抽象为类，将工具、记忆、规划、执行等能力封装成可继承、可组合的方法与属性，让开发者像写普通 Python 类一样定义智能体行为，而不是堆叠提示词或流程脚本。项目解决的是多智能体系统代码难以复用、状态管理混乱、调试困难的问题，核心能力包括：基于类的智能体定义、工具注册与调用、多智能体协作编排、运行时状态追踪，以及与 NVIDIA 生态（如 NIM 模型服务）的集成。适合需要把智能体逻辑工程化、长期维护的团队，用 Python 原生范式降低智能体开发门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 2305

使用教程

难度：入门约 5 分钟部署方式：库/依赖 6 步

环境要求

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

安装与启动步骤

1创建项目目录

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

切换到刚创建的项目目录，后续安装命令都在该目录下执行。
```
cd my-agent-project
```
3安装核心框架

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

不使用 uv 时的等价做法：在已激活的虚拟环境中用 pip 安装核心包。
```
pip install nooa
```
5安装可选子包

CLI、ACP、memory、bench 为独立发行包，按需安装，也可用 extras 一次装多个。
```
uv add nooa-cli
uv add nooa-memory
uv add "nooa[cli,memory]"
```
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 命令。

常见问题

Q：nooa 和 nooa-cli、nooa-memory 等子包是什么关系？

A：子包是独立发行版，可单独按名安装，也可作为核心包的 extras 安装，例如 nooa[cli]、nooa[memory]、nooa[acp]、nooa[bench]。

Q：不用 uv 可以吗？

A：可以，README 给出 pip install nooa 的等价方式，子包同理用 pip 安装对应包名即可。

Q：eval_pipeline 为什么 pip 装不到？

A：它没有发布到 PyPI，必须用 uv add 配合 git+子目录的形式从仓库源码安装。

Q：各子包分别提供什么能力？

A：nooa-cli 提供 nooa 命令、trace 查看器与 eval runner；nooa-acp 提供面向 ACP 宿主（如 Zed）的编码智能体；nooa-memory 提供长期记忆 MemoryManager；nooa-bench 提供 BenchAgent 与 Harbor 基准运行器。