# Xorbits Inference：讓模型部署變得簡單 🤖

Xinference Enterprise · 自我託管（Self-Hosting） · 文件

[![PyPI Latest Release](https://img.shields.io/pypi/v/xinference.svg?style=for-the-badge)](https://pypi.org/project/xinference/) [![License](https://img.shields.io/pypi/l/xinference.svg?style=for-the-badge)](https://github.com/xorbitsai/inference/blob/main/LICENSE) [![Build Status](https://img.shields.io/github/actions/workflow/status/xorbitsai/inference/python.yaml?branch=main&style=for-the-badge&label=GITHUB%20ACTIONS&logo=github)](https://actions-badge.atrox.dev/xorbitsai/inference/goto?ref=main) [![Docker Pulls](https://img.shields.io/docker/pulls/xprobe/xinference?style=for-the-badge&logo=docker)](https://hub.docker.com/r/xprobe/xinference) [![Discord](https://img.shields.io/badge/join_Discord-5462eb.svg?logo=discord&style=for-the-badge&logoColor=%23f5f5f5)](https://discord.gg/Xw9tszSkr5) [![Telegram](https://img.shields.io/badge/join_Telegram-26A5E4.svg?logo=telegram&style=for-the-badge&logoColor=white)](https://t.me/+nCNpwmySwk9iYmI1) [![Twitter](https://img.shields.io/twitter/follow/xorbitsio?logo=x&style=for-the-badge)](https://twitter.com/xorbitsio)

Xorbits Inference（Xinference）是一個強大且通用的函式庫，適用於語言模型、語音識別與多模態模型。使用 Xinference，您可以只用一條指令部署自有模型或整合的尖端模型並將其提供為服務。研究者、開發者與資料科學家皆能充分發揮現代 AI 模型的能力。

👉 加入我們的 Discord 社群！ · 加入我們的 Telegram 群組

## 🔥 重點功能與更新 ### 框架強化 - Xinference 4.0.0 已發布，支援多引擎 Xavier、異質 P/D 分離和執行階段模型重新配置：[版本說明](https://github.com/xorbitsai/inference/releases/tag/v4.0.0) - 原生 Agent 部署：Xinference 與 [Xagent](https://github.com/xorbitsai/xagent) 整合，支援動態規劃、工具使用與自動化多步驟推論，突破靜態 pipeline 的限制。 - 自動批次（Batching）：多個併發請求會自動合併以大幅提升吞吐量。 : [#4197](https://github.com/xorbitsai/inference/pull/4197) - [Xllamacpp](https://github.com/xorbitsai/xllamacpp)：Xinference 團隊維護的新一代 llama.cpp Python binding，支援連續批次並更適合生產環境。 : [#2997](https://github.com/xorbitsai/inference/pull/2997) - 分散式推論：模型可在多個 worker 之間分散執行： [#2877](https://github.com/xorbitsai/inference/pull/2877) - vLLM 改進：在多個複本之間共享 KV-cache： [#2732](https://github.com/xorbitsai/inference/pull/2732) ### 新增模型 - 內建支援 [FLUX 3 Image Klein](https://huggingface.co/black-forest-labs/flux-3-image-klein)： [#5792](https://github.com/xorbitsai/inference/pull/5792) - 內建支援 FIBO 2.0 系列（[Dev](https://huggingface.co/briaai/Fibo-2.0-dev)、[Edit Turbo](https://huggingface.co/briaai/Fibo-2.0-edit-turbo)）： [#5790](https://github.com/xorbitsai/inference/pull/5790) - 內建支援 Ming-3.0 TTS 系列（[Tiny](https://huggingface.co/inclusionAI/Ming-3.0-tts-tiny)、[0.5B](https://huggingface.co/inclusionAI/Ming-3.0-tts-0.5B)）： [#5788](https://github.com/xorbitsai/inference/pull/5788) - 內建支援 [Xiaomi-OCR-0](https://huggingface.co/SeerRay-Lab/Xiaomi-OCR-0)： [#5764](https://github.com/xorbitsai/inference/pull/5764) - 內建支援 [MOSS-Image-SFT](https://huggingface.co/OpenMOSS-Team/MOSS-Image-SFT)： [#5755](https://github.com/xorbitsai/inference/pull/5755) - 內建支援 [DeepSeek-V4.1-Flash-1017](https://huggingface.co/deepseek-ai/DeepSeek-V4.1-Flash-1017)： [#5753](https://github.com/xorbitsai/inference/pull/5753) - 內建支援 Iris-3B 系列（[Base](https://huggingface.co/speridlabs/iris-3b)、[Turbo](https://huggingface.co/speridlabs/iris-3b/tree/main/turbo)）： [#5686](https://github.com/xorbitsai/inference/pull/5686) - 內建支援 MiniCPM-V-4.7 系列（[1B](https://huggingface.co/openbmb/MiniCPM-V-4.7-1B)、[35B-A3B](https://huggingface.co/openbmb/MiniCPM-V-4.7-35B-A3B)）： [#5676](https://github.com/xorbitsai/inference/pull/5676) - 內建支援 Qwen3.8-Flash-Next 系列（[Base](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)、[FP8](https://huggingface.co/Qwen/Qwen3.8-Flash-Next-FP8)）： [#5673](https://github.com/xorbitsai/inference/pull/5673) - 內建支援 GLM-5.3 系列（[BF16](https://huggingface.co/zai-org/GLM-5.3-BF16)、[FP8](https://huggingface.co/zai-org/GLM-5.3)）： [#5666](https://github.com/xorbitsai/inference/pull/5666) - 內建支援 [Qwen-Image-2.1-Turbo](https://huggingface.co/Qwen/Qwen-Image-2.1-Turbo)： [#5665](https://github.com/xorbitsai/inference/pull/5665) - 內建支援 [DeepSeek-V4.1-Flash](https://huggingface.co/deepseek-ai/DeepSeek-V4.1-Flash)： [#5661](https://github.com/xorbitsai/inference/pull/5661) - 內建支援 [EmbeddingGemma 2](https://huggingface.co/google/embeddinggemma-2)： [#5644](https://github.com/xorbitsai/inference/pull/5644) - 內建支援 [Confucius4-TTS](https://huggingface.co/netease-youdao/Confucius4-TTS)： [#5591](https://github.com/xorbitsai/inference/pull/5591) - 內建支援 [jina-ocr-v1](https://huggingface.co/jinaai/jina-ocr-v1)： [#5588](https://github.com/xorbitsai/inference/pull/5588) ### 整合項目 - [Xagent](https://github.com/xorbitsai/xagent)：企業級 Agent 平台，具規劃、記憶與工具整合。 - [Dify](https://marketplace.dify.ai/plugin/langgenius/xinference)：LLMOps 平台，快速建立可視化與控制的應用。 - [FastGPT](https://github.com/labring/FastGPT)：基於 LLM 的知識平台，用於資料處理與模型呼叫。 - [RAGFlow](https://github.com/infiniflow/ragflow)：用於深度文件理解的開源 RAG 引擎。 - [MaxKB](https://github.com/1Panel-dev/MaxKB)：具有 RAG 整合的開源知識庫助理。 ## 主要功能 🌟 模型部署更簡單：簡化 LLM、語音識別與多模態模型的上線流程。實驗與生產模型都能透過單一命令設定與部署。 ⚡️ 方便使用的尖端模型：只需一條指令即可嘗試整合的最新模型。Xinference 提供對最先進開源模型的存取。 🖥 異構硬體支援：有效利用 GPU 與 CPU（例如透過 [ggml](https://github.com/ggerganov/ggml)），以加速推論。 ⚙️ 彈性的 API 與介面：OpenAI 相容的 RESTful API（包含 Function Calling）、RPC、CLI、Web UI 等。 🌐 分散式部署：方便在多台設備與機器間分散推論工作。 🔌 第三方整合：支援與 [LangChain](https://reference.langchain.com/python/langchain-community/llms/xinference/Xinference)、[LlamaIndex]、[Dify]、[Chatbox] 等整合。 ## 為何選擇 Xinference | 功能 | Xinference | FastChat | OpenLLM | RayLLM | |----------------------------------------------|------------|----------|---------|--------| | OpenAI 相容的 RESTful API | ✅ | ✅ | ✅ | ✅ | | vLLM 整合 | ✅ | ✅ | ✅ | ✅ | | 多種推論引擎（GGML、TensorRT） | ✅ | ❌ | ✅ | ✅ | | 支援多種平台（CPU、Metal） | ✅ | ✅ | ❌ | ❌ | | 多節點集群部署 | ✅ | ❌ | ❌ | ✅ | | 影像模型（文字→影像） | ✅ | ✅ | ❌ | ❌ | | 文字嵌入模型 | ✅ | ❌ | ❌ | ❌ | | 多模態模型 | ✅ | ❌ | ❌ | ❌ | | 語音模型 | ✅ | ❌ | ❌ | ❌ | | OpenAI 類 Function Calling 支援 | ✅ | ❌ | ❌ | ❌ | ## 使用 Xinference - **Self-Hosting Xinference Community Edition** 請依照 [快速上手指南](#開始使用) 在本地啟動 Xinference。詳細說明請參閱文件：https://inference.readthedocs.io/。 - **Xinference for Enterprise** **Xinference Enterprise** 是面向正式環境模型服務的商業版本。您可以將其部署在自己的雲端環境或資料中心，也可以選擇 **Xinference Cloud** 提供的託管專屬部署。託管 **Model API** 讓您無需維護推論基礎設施，即可透過相容 OpenAI 的 API 呼叫支援的模型。瞭解更多：[xinference.co](https://xinference.co)。如需洽詢企業需求，請[透過電子郵件聯絡我們](mailto:info@xinference.co?subject=[GitHub]Business%20License%20Inquiry)。 ## 保持更新在 GitHub 為 Xinference 加星，以取得發布更新通知。 ![star-us](../assets/stay_ahead.gif) ## 開始使用 * [文件](https://inference.readthedocs.io/en/latest/index.html) * [內建模型](https://inference.readthedocs.io/en/latest/models/builtin/index.html) * [自訂模型](https://inference.readthedocs.io/en/latest/models/custom.html) * [部署文件](https://inference.readthedocs.io/en/latest/getting_started/using_xinference.html) ### 快速上手 **pip** ```bash pip install xinference xinference-local ``` **一鍵安裝** Linux/macOS: ```bash curl -fsSL https://raw.githubusercontent.com/xorbitsai/inference/main/scripts/install.sh | sh ``` Windows PowerShell: ```powershell irm https://raw.githubusercontent.com/xorbitsai/inference/main/scripts/install.ps1 | iex ``` [安裝指南](https://inference.readthedocs.io/en/latest/getting_started/installation.html#one-line-install) · [使用指南](https://inference.readthedocs.io/en/latest/getting_started/using_xinference.html#run-xinference-locally) ### Docker 具有 NVIDIA GPU 的使用者可以使用 Xinference Docker 映像。請在安裝前確認系統已安裝 Docker 與 CUDA。 ```bash docker run --name xinference -d -p 9997:9997 -e XINFERENCE_HOME=/data -v :/data --gpus all xprobe/xinference:latest xinference-local -H 0.0.0.0 ``` ### K8s (Helm) 在已啟用 GPU 的 Kubernetes 叢集中，執行下列指令安裝： ``` # 新增 Helm 倉庫 helm repo add xinference https://xorbitsai.github.io/xinference-helm-charts # 更新索引並檢視版本 helm repo update xinference helm search repo xinference/xinference --devel --versions # 安裝 Xinference helm install xinference xinference/xinference -n xinference --version 0.0.1-v ``` 更多 K8s 選項請參閱文件。 ![web UI](../assets/screenshot.png) ## 參與專案 | 平台 | 目的 | |--------------------------------------------------------------------------|-----------------------------------------| | [Github Issues](https://github.com/xorbitsai/inference/issues) | 報告錯誤與功能請求 | | [Discord](https://discord.gg/Xw9tszSkr5) | 與其他使用者協作 | | [Telegram](https://t.me/+nCNpwmySwk9iYmI1) | 社群討論 | | [Twitter](https://twitter.com/xorbitsio) | 新聞與公告 | ## 引用若本專案對您有幫助，請以以下格式引用： ```bibtex @inproceedings{lu2024xinference, title = "Xinference: Making Large Model Serving Easy", author = "Lu, Weizheng and Xiong, Lingfeng and Zhang, Feng and Qin, Xuye and Chen, Yueguo", booktitle = "Proceedings of the 2024 Conference on Empirical Methods in Natural Language Processing: System Demonstrations", month = nov, year = "2024", address = "Miami, Florida, USA", publisher = "Association for Computational Linguistics", url = "https://aclanthology.org/2024.emnlp-demo.30", pages = "291--300", } ``` ## 貢獻者

## 星星歷史 [![Star History Chart](https://star-history.dera.page/svg?repos=xorbitsai/inference&type=Date)](https://star-history.dera.page/#xorbitsai/inference&Date)