项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4325
使用教程
环境要求
- 服务端:Docker Engine ≥ 24.0 且带 Compose v2
- 服务端:可访问 GitHub Raw 与 GHCR 镜像仓库的网络
- CLI:Python 3.11+(使用 uv 或 pipx 安装时),或直接使用免 Python 的独立二进制
- CLI:macOS/Linux 终端,可执行 curl 管道命令
安装与启动步骤
-
1一键部署服务端
下载并启动服务端 Docker Compose 栈,含 API、Web UI 和数据库;有终端时进入引导式配置。
curl -fsSL https://raw.githubusercontent.com/Observal/Observal/main/install-server.sh | bash -
2从源码部署服务端
贡献者路线:克隆仓库、复制环境变量示例文件,再用 make 拉起重服务栈。
git clone https://github.com/Observal/Observal.git && cd Observal cp .env.example .env make up -
3安装 CLI 二进制
在每台开发者机器安装 CLI,独立二进制方式无需本机 Python 环境。
curl -fsSL https://raw.githubusercontent.com/Observal/Observal/main/install.sh | bash -
4用 Python 安装 CLI
已装 uv 或 pipx 且 Python 3.11+ 时,可用包管理方式安装 observal-cli。
uv tool install observal-cli -
5查看部署文档
按 README 链接查阅安装、自托管与生产部署文档,完成后续配置与加固。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 源码部署所需环境变量文件,从示例文件复制后按需修改 | .env.example → .env |
如何确认成功
执行安装脚本后终端会显示配置与启动流程;容器栈是否正常请按 README 链接的 SETUP.md 核对。
常见问题
Q:没有 Docker 能部署服务端吗?
A:一键安装脚本明确要求 Docker Engine ≥ 24.0 与 Compose v2;不过 CLI 可独立二进制安装,不依赖 Python。
Q:CLI 必须装 Python 吗?
A:不必。可用独立二进制方式安装;若走 Python 路线则需 Python 3.11+,并可用 uv tool install 或 pipx 安装 observal-cli。
Q:默认会把端口暴露到公网吗?
A:README 说明默认把发布的端口绑定到 loopback(本机回环),外部访问需另行调整,详见自托管文档。
Q:生产环境怎么部署?
A:README 指向 docs/self-hosting/production-deploy.md 的加固生产拓扑,以及数据库、升级、备份等配套文档。
注意事项
- 一键脚本会生成归运维方所有的密钥文件,并限制容器组访问权限,请妥善保管。
- 无终端执行同样命令时会自动套用安全默认值,不会进入引导式配置。
- 源码部署前先确认已安装 Docker Compose v2,否则 make up 无法拉起服务栈。
- 升级前先阅读 upgrades 与 backup-and-restore 文档,避免数据不可回滚。
核心亮点
- 本地部署,数据不出内网,隐私安全可控
- 统一管理 Skills/MCPs/Agents,避免组件散落各处
- 内置分析功能,能看调用量、延迟等运行指标
不足之处
- 项目较新,生态和插件尚不丰富
- 文档/社区待观察
适用场景
- 企业内部 AI 组件资产盘点与复用
- 多团队协作时共享 MCP 和 Agent 配置
- 监控 AI 组件在生产环境的调用性能
替代项目
LangSmith、Langfuse、Helicone
同类项目推荐
Rapid-MLX
开源
让 Mac 跑大模型快 4 倍,工具调用全兼容
Rapid-MLX is an open-source (Apache 2.0) OpenAI- and Anthropic-compatible LLM infere···
mirage
开源
把整个LLM推理塞进一个GPU内核,砍掉反复启动开销
Mirage Persistent Kernel: Compiling LLMs into a MegaKernel
clawmetry
开源
看清智能体每一步思考,调试不再靠猜。
See your agent think. Zero-config observability & governance for 30 AI agent runtime···
ocp
开源
把 Claude 订阅变成 OpenAI API,多设备共享零成本
Turn your Claude Pro/Max subscription into an OpenAI-compatible API for your IDEs an···
sie
开源
一个服务搞定所有模型,让智能体部署不再头疼
Open-source inference server and production cluster for all the models your agent ne···
emmy
开源
选配方或自调优,让 LLM 推理在 GPU 上跑得更快
Optimized GPU compiler for LLM inference. Choose from a list of optimized recipes or···
rapid_llm
开源
用 Triton 手写轻量推理框架,快速读懂并改造 LLM 内核
RapidLLM is an LLM inference framework with continuous batching, tensor and data par···
gateway
开源
一个 API 接入 1600+ 模型,内置安全护栏,AI 应用开发提速。
A blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI G···
metaflow
开源
Netflix 同款流水线玩法,从实验到上线一路顺畅
Build, Manage and Deploy AI/ML Systems
