记忆与主动任务智能体

资源介绍

Raven 是面向持续性任务的 AI 智能体，可通过命令行运行，也可在部署后通过网页使用。用户配置模型提供方后，可以在会话中交代任务；项目还提供代码、研究、设计、演示文稿和运维方向的专用智能体，供有相应需求的用户安装与调用。Raven 的项目说明列有记忆、主动性、上下文控制和技能演进能力，适合希望让智能体接续工作、处理多步骤任务，或按任务类型分工的用户。若希望先用浏览器操作，项目提供 Docker Compose 部署方式：启动后在本地网页配置模型，再开始对话。专用智能体需要另行安装，不应将仓库中所有演示或实验内容视为默认启用的功能。

资源展示

软件界面、操作截图与实际案例预览。

Agent 能力

记忆与上下文控制

项目将记忆和上下文控制列为 Raven 的核心能力，用于支持需要接续处理的会话与任务。

主动任务能力

Raven 提供主动任务相关功能；Docker 部署启动的网关包含主动任务组件，适用于不只依赖单次问答的工作。

专用智能体

可按任务调用专用智能体，分别处理研究、编程、视觉设计和无人值守的流程自动化；演示文稿任务可通过设计智能体交由演示文稿智能体处理。

命令行与网页操作

安装包提供 raven 命令；Docker Compose 部署后可打开本地网页，在设置中配置模型并使用。

资源配置

运行平台

本地运行Docker

配置方式

配置文件环境变量Web配置API Key其他

依赖资源

安装 Raven 后需配置模型服务商；可运行 raven onboard 配置向导，之后可在 WebUI 的“设置 ＞ 模型服务商”中添加或修改配置。

运行与使用

1. 01

   选择本地安装或 Docker Compose 部署；本地安装需要 Python 3.12 或更新版本。

2. 02

   若使用 Docker 方式，在仓库的 docker 目录运行 docker compose up --build，然后打开 http://localhost:18793。

3. 03

   在网页的 Settings ＞ Models 中添加模型提供方，或通过部署环境变量预先配置提供方。

4. 04

   配置完成后在网页中发起对话；如需代码、研究等专用智能体，再按需安装对应智能体。

使用案例

代码任务分工

使用场景开发者希望将代码相关任务交给专用智能体。

在已安装 Raven 的环境中安装 raven-code，再通过支持其调用方式的客户端使用该智能体处理代码任务。

本地网页对话

使用场景用户希望通过浏览器使用 Raven，而不是直接操作命令行。

使用 Docker Compose 启动 Raven，打开本地网页，在 Settings ＞ Models 配置模型提供方后发起对话。

包含内容

✓

raven-source.zip

✓

README-中文安装说明.md

✓

LICENSE-Apache-2.0.txt

✓

THIRD-PARTY-NOTICES.md

✓

SHA256.txt

常见问题

Docker 部署后在哪里配置模型？

打开本地网页的 Settings ＞ Models 即可添加模型提供方；新配置会在下一轮调用时生效，无须重启容器。

Raven 本地安装需要什么 Python 版本？

项目的安装清单要求 Python 3.12 或更新版本。

Docker 镜像能使用 raven tui 吗？

项目提供的 Docker 镜像不包含 raven tui 所需的终端界面构建产物，因此不能直接在该镜像中使用 raven tui。

Docker 默认网页适合直接对外开放吗？

不适合。默认配置会让能访问页面的人自动获得浏览器会话，且发布端口仅绑定本机；远程部署时需关闭 RAVEN_AUTO_LOGIN，并自行配置访问入口。