litellm

环境要求

• 已安装 uv（README 明确说明 Quick Start 依赖 uv）
• 已安装 git（用于 git clone 仓库）
• 已安装 make（README 中的命令均为 make 目标）
• 如需校验镜像签名，需安装 cosign
• 如需部署 GCP 方案，需 gcloud CLI 与可用的 GCP 项目

安装与启动步骤

1. 1克隆代码库

   从 GitHub 拉取 LiteLLM 仓库并进入项目根目录。

   git clone https://github.com/BerriAI/litellm.git
   cd litellm

   复制

2. 2安装开发依赖

   执行 make install-dev 安装开发依赖，README 强调此步需要 uv 已安装。

   make install-dev

   复制

3. 3格式化代码

   执行 make format 按项目规范格式化代码，改动前建议先提交。

   make format

   复制

4. 4运行代码检查

   执行 make lint 运行全部 lint 检查，检查未通过需先修复。

   make lint

   复制

5. 5运行单元测试

   执行 make test-unit 跑单元测试，确认本地开发环境可用。

   make test-unit

   复制

6. 6校验镜像签名

   用 cosign 与固定 commit 的 cosign.pub 校验 GHCR 镜像签名。

   cosign verify \
     --key https://raw.githubusercontent.com/BerriAI/litellm/0112e53046018d726492c814b3644b7d376029d0/cosign.pub \
     ghcr.io/berriai/litellm:v1.83.0-stable

   复制

7. 7GCP 远程仓库

   若在自有 Terraform 配置中调用 GCP 模块，先建以 GHCR 为源的远程仓库。

   gcloud artifacts repositories create litellm \
     --location=us-central1 \
     --repository-format=docker \
     --mode=remote-repository \
     --remote-docker-repo=https://ghcr.io \
     --project=my-gcp-project

   复制

关键配置

如何确认成功

make test-unit 通过说明开发环境就绪；cosign verify 返回验签成功说明镜像可信。

常见问题

注意事项

• README 中的 Quick Start 是面向贡献者的开发模式，并非生产环境部署指南。
• 所有发布到 GHCR 的 Docker 镜像都用 cosign 签名，推荐用固定 commit hash 0112e53 校验最可靠。
• 校验命令中的 <release-tag> 需替换为你实际部署的版本，例如 v1.83.0-stable。
• 文档仓库已独立，代码 PR 与文档 PR 需分别提交到不同仓库。