-->
-->
-->
-->
-->
-->
-->
-->
-->
-->
-->
-->
-->
██████╗ ██████╗ ███████╗███████╗██████╗ ██╗ ██╗ █████╗ ██╗ ██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██║ ██║██╔══██╗██║ ██║ ██║██████╔╝███████╗█████╗ ██████╔╝██║ ██║███████║██║ ██║ ██║██╔══██╗╚════██║██╔══╝ ██╔══██╗╚██╗ ██╔╝██╔══██║██║ ╚██████╔╝██████╔╝███████║███████╗██║ ██║ ╚████╔╝ ██║ ██║███████╗ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═══╝ ╚═╝ ╚═╝╚══════╝
发现、共享和监控内置完全可观察性的AI编码代理。
如果你觉得Observal有用，请考虑给它一颗星。它帮助其他人发现项目并保持开发。
______________________________________________________________________
Observal是一个 具有内置可观察性的自托管AI代理注册表。想想Docker Hub，但适用于AI编码代理。
浏览他人创建的代理，发布自己的代理，并提取完整的代理配置——所有这些配置都以可移植的YAML格式定义，模板输出到 克劳德代码, Kiro命令行界面, 光标, Gemini CLI以及更多。每个代理都将其MCP服务器、技能、钩子、提示和沙盒捆绑到一个可安装的包中。一个安装命令，零手动配置。
每次交互都会生成流入遥测管道的跟踪、跨度和会话。内置的eval引擎对代理会话进行评分，以便您可以衡量性能，并随着时间的推移使您的代理变得更好。
代理注册表
浏览、搜索和安装已发布的代理
仪表板
代理得分、最近会话、热门下载
跟踪详细信息
每次工具调用：模型、令牌计数、16圈
洞察报告
人工智能生成的代理使用模式分析
错误日志
钻取会话时出现的分类错误
审核队列
管理员批准/拒绝提交的工作流
文档
完整文档在线 Docs.observation al.io
看 更改日志.md 查看最新更新。
快速开始
单线安装（推荐）
curl -fsSL https://raw.githubusercontent.com/BlazeUp-AI/Observal/main/install-server.sh | bash下载一个轻量级的配置包，运行一个有指导的设置，从GHCR中提取预构建的Docker镜像，并启动整个堆栈。不需要回购克隆。
来源
git clone https://github.com/BlazeUp-AI/Observal.git && cd Observal
cp .env.example .env
make up连接IDE
uv tool install observal-cli
observal auth login这将在IDE中安装钩子（Claude Code、Kiro等）以自动捕获跟踪。
看 设置.md 查看完整的设置指南。
支持的IDE
| IDE | 支持 |
|---|---|
| Claude Code | 完整-技能、钩子、MCP、规则、OTLP遥测 |
| Kiro CLI | 完整版——超能力、挂钩、MCP、转向文件、OTLP遥测 |
| Gemini CLI | 已测试--挂钩、MCP、规则、OTLP遥测 |
| 光标 | 已测试--MCP+垫片遥测，规则 |
| VS代码 | 有限--MCP+垫片遥测，规则 |
| 副驾驶CLI | 有限--挂钩、MCP+垫片遥测、规则 |
| Codex CLI | 有限-规则 |
| OpenCode | 有限——JS插件挂钩、MCP+垫片遥测、规则 |
兼容性矩阵和每个IDE设置： 集成.
技术栈
| 组件 | 技术 |
|---|---|
| 前端 | Next.js 16、React 19、顺风CSS 4、shadcn/ui、Recharts |
| 后端 | Python 3.11+、FastAPI、草莓GraphQL、Uvicorn |
| 数据库 | PostgreSQL 16（注册表），ClickHouse（遥测） |
| 队列 | Redis+arq |
| CLI | Python、Typer、Rich |
| Eval引擎 | AWS Bedrock/OpenAI兼容LLM |
| 遥测 | 开放遥测采集器 |
| 部署 | Docker Compose（10项服务） |
贡献
看 贡献.md.简短版本：
- 分叉和克隆
make hooks安装预提交挂钩- 创建要素分支
- 跑
make lint和make test - 打开PR
看 代理商.md 用于内部代码库上下文。
运行测试
make test # quick
make test-v # verbose所有测试都模拟外部服务。不需要Docker。
社区
有问题、想法或想分享你所创造的东西吗？前往 请使用讨论来回答问题；已确认的错误和具体功能请求的未解决问题。
加入 观测不一致 直接与维护人员和其他社区成员聊天。
报告问题
提交错误报告时，请附上支持包，以便维护人员快速诊断问题：
observal support bundle这产生了一个 .tar.gz 包含版本信息、净化配置、健康探测、聚合表计数和可选系统指标的存档。所有值都经过一个编校层——不包括客户数据、行内容或凭据。共享前查看捆绑包：
observal support inspect observal-support-*.tar.gz安全
要报告漏洞，请使用 或电子邮件contact@blazeup.app. 不要公开问题。 看 安全.md.
明星历史
许可证
GNU Affero通用公共许可证v3.0（AGPL-3.0）。看 许可证.