项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3279
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 与 npm(用于执行 npm install)
- Docker 与 Docker Compose(用于拉起基础设施与完整栈)
- 项目根目录下的 .env 文件;使用 Docker 时还需 .env.docker 文件
安装与启动步骤
-
1安装 NPM 依赖
在 Pezzo 项目根目录执行 npm install,安装前端与后端所需的全部 NPM 依赖。
npm install -
2准备环境变量文件
Pezzo 使用 .env 存放环境变量;用 Docker 时还需创建 .env.docker。具体内容参照 .env.example 填写。
-
3启动基础设施依赖
Pezzo 依赖 PostgreSQL、ClickHouse、Redis 和 Supertokens,通过 Docker Compose 一次性拉起这些服务。
docker-compose -f docker-compose.infra.yaml up
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 存放 Pezzo 运行所需的环境变量 | 参照 .env.example 填写 |
.env.docker | 是 | 使用 Docker 运行时额外需要的环境变量文件 | 参照 .env.example 填写 |
如何确认成功
docker-compose 输出无报错,PostgreSQL、ClickHouse、Redis、Supertokens 容器均正常启动运行。
常见问题
Q:只想在本地跑起完整的 Pezzo 栈怎么办?
A:README 建议直接查阅官方文档中的“Running With Docker Compose”一节,用 Docker Compose 启动完整栈,无需手动进入开发模式。
Q:Pezzo 依赖哪些外部服务?
A:完全云原生,仅依赖开源组件:PostgreSQL、ClickHouse、Redis 和 Supertokens,均已包含在 docker-compose.infra.yaml 中。
Q:环境变量该写哪些内容?
A:README 未列出具体变量,请以项目根目录的 .env.example 为参考填写 .env;使用 Docker 时同时创建 .env.docker。
Q:开发模式后续如何启动 API 和 Web UI?
A:README 未给出这部分命令,请前往官方文档 https://docs.pezzo.ai/ 查看架构说明、教程与各 LLM 提供商的接入方式。
注意事项
- README 仅明确给出 npm install 与 docker-compose.infra.yaml 两条命令,其余启动步骤请以官方文档为准,不要自行猜测命令与端口。
- 该仓库同时提供 Docker Compose 完整栈部署方式,官方文档地址为 http://docs.pezzo.ai/introduction/docker-compose。
- Pezzo 使用 TypeScript/NestJS 构建,配套 npm 客户端包为 @pezzo/client。
- 项目官网为 https://pezzo.ai,遇到问题可查阅官方文档或社区渠道。
核心亮点
- 可视化提示词编辑与版本管理,支持一键回滚,降低协作成本
- 内置缓存和日志追踪,提供请求级可观测性,便于排查问题
- 支持多 LLM 提供商切换,并深度集成 LangChain,灵活适配
不足之处
- 项目仍处于早期阶段,文档和社区生态有待完善
- 高级功能(如自托管、权限管理)可能需要付费或企业版支持
适用场景
- 团队协作开发 LLM 应用,需要统一管理提示词和版本
- 生产环境需要监控 LLM 调用性能、成本和异常
- 快速原型验证,需要可视化调试和即时发布
替代项目
Langfuse、Helicone、PromptLayer
同类项目推荐
llama.cpp
开源
用普通电脑本地跑大模型,量化后 CPU 也能流畅推理
LLM inference in C/C++
gateway
开源
本地统一调用 200+ 大模型,告别接口碎片化
The only fully local production-grade Super SDK that provides a simple, unified, and···
rtp-llm
开源
阿里出品的高性能推理引擎,让LLM部署更快更省
RTP-LLM: Alibaba's high-performance LLM inference engine for diverse applications.
OmniKey-AI-Unified-Key-Manager
开源
统一管理多平台 LLM 密钥,自动故障转移,调用更稳更省心。
A self-hosted LLM proxy and failover gateway supporting OpenAI & Gemini compatible e···
NanoLLM
开源
本地跑大模型,量化多模态一条龙
Optimized local inference for LLMs with HuggingFace-like APIs for quantization, visi···
popmon
开源
自动监控数据漂移,及时预警异常变化
Monitor the stability of a Pandas or Spark dataframe ⚙︎
ck
开源
一键自动化AI基准测试与调优,跨硬件高效跑通MLPerf
Collective Knowledge (CK), Collective Mind (CM/CMX) and MLPerf automations: communit···
Windows-Copilot-API
开源
把 Windows Copilot 变成 OpenAI 兼容接口,开箱即调
Reverse engineered Windows Copilot into an OpenAI-compatible API. Access GPT-4 and G···
aisix-archived
开源
用 Rust 打造你的 AI 网关,统一管理多模型请求
An open source, Native AI Gateway and LLM proxy built in Rust
