
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4937
技术标签
使用教程
环境要求
- 操作系统:macOS 或 Linux
- Python ≥ 3.12
- Docker(仅容器执行模式需要,本地模式不需要)
- 本地模式需已安装并登录 claude / codex / pi CLI
安装与启动步骤
-
1确认系统与依赖
确认是 macOS 或 Linux,且 Python 版本不低于 3.12;若用容器模式还需 Docker 可用。
-
2拉取基础镜像
Cairn 镜像基于该 uv 基础镜像构建,先拉取可加快后续 compose 构建。
docker pull ghcr.io/astral-sh/uv:python3.13-trixie -
3Compose 启动服务
在项目根目录执行。会启动 cairn-server(8000 端口),健康检查通过后启动 cairn-dispatcher。
docker compose up --build -
4仅跑启动健康检查
不进入完整调度流程,只验证各 worker 与配置是否就绪,适合排错时单独运行。
uv run --project cairn cairn dispatch --config dispatch.yaml --startup-healthcheck-only -
5单独运行 dispatcher
需要单独启动调度器时使用,挂载项目根目录的 dispatch.yaml 并连接宿主机 Docker socket。
uv run --project cairn cairn dispatch --config dispatch.yaml -
6切到本地模式配置
复制本地模式示例配置为实际使用的 dispatch.yaml,本地模式不依赖 Docker。
cp dispatch.local.example.yaml dispatch.yaml -
7本地模式启动
必须在宿主机(而非 Docker 内)执行,agent 以当前用户权限运行且无沙箱。
uv run --project cairn cairn dispatch --config dispatch.yaml
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
dispatch.yaml | 是 | 调度器主配置文件,位于项目根目录,由 compose 挂载进容器 | dispatch.yaml |
runtime.execution | 否 | 设为 local 时启用本地模式,worker 直接跑在宿主机上 | local |
local.workspace_root | 否 | 本地模式下每个项目的隔离工作目录,默认取调度器当前目录 | /your/workspace |
如何确认成功
docker compose 日志显示 cairn-server 通过健康检查、cairn-dispatcher 随之启动,服务监听 8000 端口;也可用 --startup-healthcheck-only 单独验证。
常见问题
Q:本地模式需要 Docker 吗?
A:不需要。容器执行模式才依赖 Docker;本地模式直接复用宿主机上已配置好的 claude / codex / pi CLI,配置里也无需放 API Key。
Q:本地模式为什么不能跑在 Docker 里?
A:因为 agent 以你的用户权限运行且没有沙箱隔离,README 明确要求把调度器直接跑在宿主机上。
Q:容器模式的数据保存在哪里?
A:README 说明数据持久化到项目下的 ./datas/cairn/ 目录。
Q:怎么快速确认环境配置没问题?
A:用 uv run --project cairn cairn dispatch --config dispatch.yaml --startup-healthcheck-only 只跑启动健康检查。
注意事项
- 目前仅支持 macOS 与 Linux 系统
- Docker 只用于容器执行模式,本地模式无需安装 Docker
- 本地模式启动时会校验各 worker CLI 是否安装可运行,并提示必须已登录
- cairn-server 默认占用 8000 端口,注意端口冲突
核心亮点
- 利用LLM自主规划攻击路径,减少人工干预
- 支持黑盒测试和CTF场景,适用范围广
- 集成多种安全工具,自动化程度高
不足之处
- 依赖LLM,可能产生误判或漏报
- 文档/社区待观察
适用场景
- 企业安全团队进行定期渗透测试
- CTF竞赛中的自动化解题辅助
- 安全研究中的漏洞发现与验证
替代项目
AutoGPT、PentestGPT、Metasploit
下一篇:open-science
同类项目推荐
WhaticketPlus
开源
一个账号多人用,自动开票,AI 加持,客服效率翻倍。
Atendimento lento e clientes insatisfeitos? Automatize a abertura de tickets no What···
keep
开源
统一管理监控告警,智能降噪,让运维不再被警报淹没。
The open-source AIOps and alert management platform
VoiceHub
开源
拖拽排期、投票点歌,校园广播一站搞定
这是一个使用Nuxt 4全栈框架开发的低成本校园广播站点歌系统。系统提供完整的点歌投票、排···
JourniOne-Planning-Skills
开源
一句话让 AI 生成带地图、可分享的逐日旅行日志
JourniOne 旅行规划 Skill:从灵感与逐日路线,到带地图、可分享的 Travel Journal,按需衔···
giza-pp
开源
用平行语料训练词对齐模型,输出双语词对应关系
GIZA++ is a statistical machine translation toolkit that is used to train IBM Models···
bazi-ziwei-skill
开源
让 AI 精准排八字紫微,一键生成水墨命盘海报
AI 八字 + 紫微斗数排盘与综合印证 Skill:算法精准排盘(不靠 LLM 猜),三种分析模式,一···
Word2World
开源
输入故事,一键生成可玩的2D游戏世界
Word2World is an LLM-based PCG system that creates playable 2D world from stories
Epona
开源
用扩散模型预测驾驶未来,生成连续视频帧。
Official Code for Epona: Autoregressive Diffusion World Model for Autonomous Driving···
Bob
开源
macOS 上划词即译、截图即识,多引擎翻译一步到位
Bob 是一款 macOS 平台的翻译和 OCR 软件。