8treenet/goraven

GoRaven – 自托管 AI 代理平台

功能简介 – GoRaven 是一个自托管运行时，让每位团队成员在自己的“工作区”中与自主 AI 代理协作。代理可以读写文件、运行 shell 命令、调用 API、查询 RAG 知识库，并生成具体成果，如代码、报告或图表。重点是完成工作，而不仅仅是返回聊天响应。

主要特性

• 面向团队的工作区 – 每个用户拥有隔离环境，支持共享项目，以及管理员控制的模型配额和工具权限。
• 技能市场 – 可复用的提示词、脚本和工作流（称为技能），可一键安装并集中维护。
• 支持 RAG 的推理 – 政策、文档和其他业务资料被索引；代理在执行时检索相关上下文，因此答案有据可依，而非凭空捏造。
• 插件钩子 – 可在对话、工具调用或 SSE 流之前/之后注入自定义逻辑，无需修改核心即可深度集成。
• 完全自托管 – 单个 Docker 命令即可运行整个堆栈（Go 后端、React/TS 前端、Tailwind CSS，以及捆绑的运行时，如 Python、Git 等）。数据永不离开服务器，可使用任何兼容 LLM 的 API（OpenAI、Claude、DeepSeek、Qwen、GLM 等）。
• 可观测性优先设计 – 执行步骤被暴露，用户可以看到代理在做什么，使调试和迭代改进更容易。

如何试用

# 拉取官方镜像
docker pull 8treenet/goraven:latest

# 运行（暴露端口 8000）
 docker run -d --restart=always --name goraven-agent \
   -p 8000:8000 8treenet/goraven:latest

挂载主机目录（/opt/goraven:/goraven/data）以保持工作区持久化。容器启动后，打开 http://localhost:8000 并按照向导创建管理员账户。

架构概览 – README 包含一个图表，显示 Go 后端编排 LLM 调用、工具执行和 RAG 检索，而 React + TypeScript 前端提供 UI。系统通过 Docker 打包，部署简单。

适用对象 – 需要内部 AI 助手执行实际任务（代码生成、数据分析、报告编写等）的团队，同时保持数据本地化，并保留对模型、工具和权限的控制。

许可证 – Apache 2.0，允许商业使用和修改。

---

以上信息均直接取自仓库的 README。