LiteLLM 版本發布版號制度正在變更：採用標準命名、每週發版升級 MINOR、hotfix 保留 PATCH
最後更新：2026 年 7 月
main-stable 已淘汰；請遷移至 :latest舊版 main-stable Docker 標籤仍會每週前進，因此現有部署可繼續運作。我們目標在 2026 年 9 月 1 日 停止發布它，不過該日期仍在透過 公開的淘汰討論 最終確認中，可能會因回饋而變動。未來，:latest 將是指向最新穩定映像的標準滾動指標；每次穩定版發布時會自動前進，並符合標準 Docker 慣例。
main-stable 沿用了先前的命名方案，且不符合現代慣例：它將「main」（通常是開發分支）與「stable」（發布通道）混在一起，而且沒有對應的 PyPI 版本。
遷移：
- 滾動穩定版（Docker） →
ghcr.io/berriai/litellm:latest - 可重現固定版（Docker） →
ghcr.io/berriai/litellm:1.84.0 - 可重現固定版（PyPI） →
pip install litellm==1.84.0
此橫幅會在時程確認後更新。
LiteLLM 發布版名稱正在變更。以下兩個痛點一直是推動因素：
1. -stable 和 -nightly 後綴不是標準格式。
像 v1.83.3-stable 和 v1.83.0-nightly 這類版本不符合 PEP 440（PyPI）或 SemVer 2.0（Docker / Helm）慣例。期待標準版本字串的使用者會感到困惑，而分類版本的工具也必須針對該後綴做特殊處理。
2. 每週發版一直在升級 PATCH，導致真正的 hotfix 沒有空間。
在舊模型下，每次排定的每週發版都會升級 PATCH 數字：1.83.0 -> 1.83.1 -> 1.83.2 -> 1.83.3。當 1.83.3 需要真正的 hotfix 時，下一個 PATCH（1.83.4）已經保留給下一週的發版。Docker 的變通作法是 v1.83.3-stable.patch.1 - 但 PyPI 不接受這種語法，因此同時需要 Docker 映像與 Python wheel 的 hotfix 沒有乾淨的發布方式。