xorbitsai/inference

Xorbits Inference(Xinference) is a powerful and versatile library designed to serve language, speech recognition, and multimodal models. With Xorbits Inference, you can effortlessly deploy and serve your or state-of-the-art built-in models using just a single command. Whether you are a researcher, developer, or data scientist, Xorbits Inference empowers you to unleash the full potential of cutting-edge AI models.

🔥 Hot Topics

Framework Enhancements

• Xinference 3.0.0 is available with migration notes and breaking changes: Release Notes
• Agent-native Serving: Xinference integrates with Xagent to enable dynamic planning, tool use, and autonomous multi-step reasoning — moving beyond static pipelines.
• Auto batch: Multiple concurrent requests are automatically batched, significantly improving throughput: #4197
• Xllamacpp: New llama.cpp Python binding, maintained by Xinference team, supports continuous batching and is more production-ready.: #2997
• Distributed inference: running models across workers: #2877
• VLLM enhancement: Shared KV cache across multiple replicas: #2732

New Models

• Built-in support for MiniCPM5-2B: #5506
• Built-in support for Fish Audio series (S1-mini, S2-Pro): #5490
• Built-in support for MonkeyOCR: #5475
• Built-in support for dots.ocr: #5468
• Built-in support for JoyAI image editing series (Edit, Edit Plus): #5458
• Built-in support for Breeze-TTS-2: #5437
• Built-in support for WeMM-Embedding series (2B, 4B, 9B): #5439
• Built-in support for NaviDC-OCR: #5431
• Built-in support for Kimi-K3: #5417
• Built-in support for world models (Matrix-Game-3.0-5B, HY-WorldPlay-5B, Astra): #5414
• Built-in support for Krea 2 series (Raw, Turbo): #5419
• Built-in support for ACE-Step 1.5: #5413
• Built-in support for Ornith 1.5 series (35B-A3B, 397B): #5406, #5405
• Built-in support for GLM-5.2: #5404
• Built-in support for GLM-Image: #5394
• Built-in support for HiDream-O1 series (Image, Image-Dev, Image-Dev-2604): #5370
• Built-in support for SenseNova-U1.5-8B-MoT: #5369
• Built-in support for Ideogram4: #5367
• Built-in support for DeepSeek-V4-Flash-0731: #5371
• Built-in support for FireRedTTS3: #5352
• Built-in support for MiniMax-H3 Lightning LoRA: #5338
• Built-in support for MiniMax-Music3: #5345
• Built-in support for Qwen3.8 series (27B, 2.4T-A95B): #5337, #5339
• Built-in support for jina-reranker-m0: #5327

Integrations

• Xagent: an enterprise agent platform for building and running AI agents with planning, memory, and tool use — not limited to rigid workflows.
• Dify: an LLMOps platform that enables developers (and even non-developers) to quickly build useful applications based on large language models, ensuring they are visual, operable, and improvable.
• FastGPT: a knowledge-based platform built on the LLM, offers out-of-the-box data processing and model invocation capabilities, allows for workflow orchestration through Flow visualization.
• RAGFlow: is an open-source RAG engine based on deep document understanding.
• MaxKB: MaxKB = Max Knowledge Brain, it is a powerful and easy-to-use AI assistant that integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities.

Key Features

🌟 Model Serving Made Easy: Simplify the process of serving large language, speech recognition, and multimodal models. You can set up and deploy your models for experimentation and production with a single command.

⚡️ State-of-the-Art Models: Experiment with cutting-edge built-in models using a single command. Inference provides access to state-of-the-art open-source models!

🖥 Heterogeneous Hardware Utilization: Make the most of your hardware resources with ggml. Xorbits Inference intelligently utilizes heterogeneous hardware, including GPUs and CPUs, to accelerate your model inference tasks.

⚙️ Flexible API and Interfaces: Offer multiple interfaces for interacting with your models, supporting OpenAI compatible RESTful API (including Function Calling API), RPC, CLI and WebUI for seamless model management and interaction.

🌐 Distributed Deployment: Excel in distributed deployment scenarios, allowing the seamless distribution of model inference across multiple devices or machines.

🔌 Built-in Integration with Third-Party Libraries: Xorbits Inference seamlessly integrates with popular third-party libraries including LangChain, LlamaIndex, Dify, and Chatbox.

Why Xinference

| Feature | Xinference | FastChat | OpenLLM | RayLLM | |------------------------------------------------|------------|----------|---------|--------| | OpenAI-Compatible RESTful API | ✅ | ✅ | ✅ | ✅ | | vLLM Integrations | ✅ | ✅ | ✅ | ✅ | | More Inference Engines (GGML, TensorRT) | ✅ | ❌ | ✅ | ✅ | | More Platforms (CPU, Metal) | ✅ | ✅ | ❌ | ❌ | | Multi-node Cluster Deployment | ✅ | ❌ | ❌ | ✅ | | Image Models (Text-to-Image) | ✅ | ✅ | ❌ | ❌ | | Text Embedding Models | ✅ | ❌ | ❌ | ❌ | | Multimodal Models | ✅ | ❌ | ❌ | ❌ | | Audio Models | ✅ | ❌ | ❌ | ❌ | | More OpenAI Functionalities (Function Calling) | ✅ | ❌ | ❌ | ❌ |

Using Xinference

• Self-hosting Xinference Community Edition
  

Quickly get Xinference running in your environment with this starter guide. Use our documentation for further references and more in-depth instructions.

• Xinference for enterprise / organizations
  

We provide additional enterprise-centric features. send us an email to discuss enterprise needs.

Staying Ahead

Star Xinference on GitHub and be instantly notified of new releases.

Getting Started

• Docs
• Built-in Models
• Custom Models
• Deployment Docs

Docker

Nvidia GPU users can start Xinference server using Xinference Docker Image. Prior to executing the installation command, ensure that both Docker and CUDA are set up on your system.

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 via helm

Ensure that you have GPU support in your Kubernetes cluster, then install as follows.

# add repo
helm repo add xinference https://xorbitsai.github.io/xinference-helm-charts
update indexes and query xinference versions
helm repo update xinference
helm search repo xinference/xinference --devel --versions
install xinference
helm install xinference xinference/xinference -n xinference --version 0.0.1-v<xinference_release_version>

For more customized installation methods on K8s, please refer to the documentation.

Quick Start

Install Xinference by using pip as follows. (For more options, see Installation page.)

pip install "xinference[all]"

To start a local instance of Xinference, run the following command:

$ xinference-local

Once Xinference is running, there are multiple ways you can try it: via the web UI, via cURL, via the command line, or via the Xinference’s python client. Check out our [docs]( https://inference.readthedocs.io/en/latest/getting_started/using_xinference.html#run-xinference-locally) for the guide.

Getting involved

| Platform | Purpose | |-------------------------------------------------------------------------------------------------|---------------------------------------------| | Github Issues | Reporting bugs and filing feature requests. | | Discord | Collaborating with other Xinference users. | | Telegram | Chatting with other Xinference users. | | Twitter | Staying up-to-date on new features. |

Citation

If this work is helpful, please kindly cite as:

@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",
}

Contributors

Star History