项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1630
使用教程
环境要求
- macOS 12+(Apple 芯片)、Windows x64,或 Debian/Ubuntu/Astra Linux 等 x86_64 发行版
- 桌面版无需 Python 或 uv,下载安装包即可使用
- 需配置至少一个受支持的远程模型提供商 API Key,或一个本地 GGUF 模型
- Linux 以 AppImage 方式运行时,主机需已安装 Git
- 仅开发/改源码时才需要克隆仓库并安装 uv 0.12.1
安装与启动步骤
-
1下载安装包
按系统选择:macOS 用 .dmg,Windows 用 windows-x64.zip,Linux 用 .deb/.rpm/AppImage。普通用户无需克隆仓库。
-
2macOS 安装启动
打开 DMG,把 Ouroboros.app 拖到 Applications 快捷方式,再从启动台打开;被 Gatekeeper 拦截时右键选择“打开”。
-
3Windows 解压运行
解压下载的 ZIP,进入解压出的 Ouroboros 文件夹,双击运行 Ouroboros.exe 即可。
-
4Linux 包管理器安装
Debian/Ubuntu/Astra Linux 用 deb 包安装,Fedora/RHEL 则把命令换成 sudo dnf install ./ouroboros-*.x86_64.rpm。
sudo apt install ./ouroboros_*_amd64.deb -
5Linux AppImage 运行
先赋予可执行权限再运行;若 FUSE 不可用,用 APPIMAGE_EXTRACT_AND_RUN=1 前缀运行同一文件。
chmod +x Ouroboros-7.0.0-linux-x86_64.AppImage ./Ouroboros-7.0.0-linux-x86_64.AppImage -
6可选安装命令行
桌面包内已带 CLI 安装器;Linux 执行该脚本会在用户目录创建 ouroboros 命令,无需 sudo,macOS 则在 DMG 中双击 Install CLI.command。
./Ouroboros/bin/install-ouroboros-cli -
7配置模型访问
首次运行向导会引导你完成模型访问、评审策略与预算设置;不配置任何远程 API Key 或本地 GGUF 模型就无法执行任务。
-
8源码方式运行
仅开发或改源码时使用:安装 uv 0.12.1、克隆仓库、同步依赖,再启动服务并访问本地地址。
curl -LsSf https://astral.sh/uv/0.12.1/install.sh | sh git clone https://github.com/razzant/ouroboros.git cd ouroboros uv sync --locked --extra browser --group dev source .venv/bin/activate ouroboros server
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
远程提供商 API Key | 是 | 首次运行向导中填写,至少配置一个才能执行任务 | sk-xxxxxxxx |
本地 GGUF 模型 | 否 | 不使用远程 API 时,改用本地 GGUF 模型做推理 | /your/path/model.gguf |
本地服务地址 | 否 | 源码模式启动服务后访问的默认地址 | http://127.0.0.1:8765 |
如何确认成功
桌面应用打开后进入首次运行向导即安装成功;源码模式在浏览器打开 http://127.0.0.1:8765 能看到设置向导。
常见问题
Q:必须安装 Python 或 uv 吗?
A:不需要。README 明确说明桌面版用户直接下载安装包即可,不必克隆仓库或安装 Python、uv;只有开发或改源码才需要。
Q:macOS 提示无法打开应用怎么办?
A:这是 Gatekeeper 拦截,右键点击 Ouroboros.app 并选择“打开”即可放行。
Q:AppImage 启动报错或缺少库?
A:FUSE 不可用时加 APPIMAGE_EXTRACT_AND_RUN=1 运行;若浏览器引擎缺共享库,改用 deb/rpm 包,或用内置 python3 执行 playwright install-deps chromium webkit。
Q:安装完成却无法执行任务?
A:需要至少配置一个受支持的远程提供商 API Key,或一个本地 GGUF 模型,可在首次运行向导里完成。
注意事项
- Ouroboros 的仓库、持久记忆、历史和界面都保存在本机,模型推理可走远程 API 或本地 GGUF。
- 准备修改 Ouroboros 本体前,必须先阅读 CONTRIBUTING.md,其中定义了项目上下文、验证和独立评审流程。
- 桌面安装包内含可选 CLI 安装器,安装到用户目录,不需要 sudo 权限。
- Chromium 与 WebKit 二进制已随包提供,但其发行版级共享库仍需主机自行满足。
核心亮点
- 引入后台意识机制,智能体可持续感知环境并主动决策
- 支持桌面操作与代码生成,覆盖开发与日常自动化场景
- 自我创建与迭代架构,突破传统智能体静态任务限制
不足之处
- 项目处于早期阶段,稳定性与生产可用性待验证
- 文档/社区待观察
适用场景
- 长期无人值守的自动化运维与监控
- 自主开发辅助:根据需求自动编写和优化代码
- 桌面级智能助手:模拟人类操作完成复杂任务
替代项目
AutoGPT、BabyAGI、MetaGPT
上一篇:open-reverselab
同类项目推荐
SWE-AF
开源
让AI代理集群自动完成从规划到提交PR的全流程
Autonomous software engineering fleet of AI agents for production-grade PRs on Agent···
Front-End-Checklist
开源
照着清单做,前端开发不踩坑
The essential checklist for modern web development, for humans and AI agents
full-stack-ai-agent-template
开源
一键生成全栈AI应用,内置Agent、RAG和认证,开箱即用。
Full-stack AI app generator — FastAPI + Next.js with AI Agents, RAG, streaming, aut···
streamcore-server
开源
用 Go 打造低延迟实时语音智能体,支持打断和本地部署。
Open-source realtime voice agent server in Go with WebRTC (WHIP), barge-in, streamin···
agent-skill-lecture-builder
开源
输入主题或讲稿,一键生成美观的 HTML 课程页面
提供主題 or Markdown 講稿,透過 Agent Skills 單一 HTML 課程頁面。
XianyuAutoAgent
开源
闲鱼自动值守,AI帮你砍价成交
智能闲鱼客服机器人系统:专为闲鱼平台打造的AI值守解决方案,实现闲鱼平台7×24小时自动化···
eve-software-factory-template
开源
用智能体流水线自动把需求变成代码
Meet Foreman, an eve Software Factory.
memorix
开源
让所有 AI 编程助手共享记忆,告别重复上下文。
Open-source cross-agent memory layer for coding agents via MCP. Compatible with Clau···
agent-skills
开源
给 AI 装上实时联网技能,搜索、提取、金融数据一键接入。
You.com skills and plugins for web search, content extraction, research, finance, an···
