langchain/docs/extras/integrations/llms
Jiayi Ni 1efb9bae5f
FEAT: Integrate Xinference LLMs and Embeddings (#8171)
- [Xorbits
Inference(Xinference)](https://github.com/xorbitsai/inference) is a
powerful and versatile library designed to serve language, speech
recognition, and multimodal models. Xinference supports a variety of
GGML-compatible models including chatglm, whisper, and vicuna, and
utilizes heterogeneous hardware and a distributed architecture for
seamless cross-device and cross-server model deployment.
- This PR integrates Xinference models and Xinference embeddings into
LangChain.
- Dependencies: To install the depenedencies for this integration, run
    
    `pip install "xinference[all]"`
    
- Example Usage:

To start a local instance of Xinference, run `xinference`.

To deploy Xinference in a distributed cluster, first start an Xinference
supervisor using `xinference-supervisor`:

`xinference-supervisor -H "${supervisor_host}"`

Then, start the Xinference workers using `xinference-worker` on each
server you want to run them on.

`xinference-worker -e "http://${supervisor_host}:9997"`

To use Xinference with LangChain, you also need to launch a model. You
can use command line interface (CLI) to do so. Fo example: `xinference
launch -n vicuna-v1.3 -f ggmlv3 -q q4_0`. This launches a model named
vicuna-v1.3 with `model_format="ggmlv3"` and `quantization="q4_0"`. A
model UID is returned for you to use.

Now you can use Xinference with LangChain:

```python
from langchain.llms import Xinference

llm = Xinference(
    server_url="http://0.0.0.0:9997", # suppose the supervisor_host is "0.0.0.0"
    model_uid = {model_uid} # model UID returned from launching a model
)

llm(
    prompt="Q: where can we visit in the capital of France? A:",
    generate_config={"max_tokens": 1024},
)
```

You can also use RESTful client to launch a model:
```python
from xinference.client import RESTfulClient

client = RESTfulClient("http://0.0.0.0:9997")

model_uid = client.launch_model(model_name="vicuna-v1.3", model_size_in_billions=7, quantization="q4_0")
```

The following code block demonstrates how to use Xinference embeddings
with LangChain:
```python
from langchain.embeddings import XinferenceEmbeddings

xinference = XinferenceEmbeddings(
    server_url="http://0.0.0.0:9997",
    model_uid = model_uid
)
```

```python
query_result = xinference.embed_query("This is a test query")
```

```python
doc_result = xinference.embed_documents(["text A", "text B"])
```

Xinference is still under rapid development. Feel free to [join our
Slack
community](https://xorbitsio.slack.com/join/shared_invite/zt-1z3zsm9ep-87yI9YZ_B79HLB2ccTq4WA)
to get the latest updates!

- Request for review: @hwchase17, @baskaryan
- Twitter handle: https://twitter.com/Xorbitsio

---------

Co-authored-by: Bagatur <baskaryan@gmail.com>
2023-07-27 21:23:19 -07:00
..
ai21.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
aleph_alpha.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
amazon_api_gateway_example.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
anyscale.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
azure_openai_example.ipynb Update Integrations links (#8206) 2023-07-24 21:20:32 -07:00
azureml_endpoint_example.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
banana.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
baseten.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
beam.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
bedrock.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
cerebriumai_example.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
chatglm.ipynb Change with_history option to False for ChatGLM by default (#8076) 2023-07-24 15:46:02 -07:00
clarifai.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
cohere.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
ctransformers.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
databricks.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
deepinfra_example.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
forefrontai_example.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
google_vertex_ai_palm.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
gooseai_example.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
gpt4all.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
huggingface_hub.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
huggingface_pipelines.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
huggingface_textgen_inference.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
index.mdx mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
jsonformer_experimental.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
koboldai.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
llamacpp.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
llm_caching.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
manifest.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
modal.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
mosaicml.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
nlpcloud.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
octoai.ipynb Add api cross ref linking (#8275) 2023-07-26 12:38:58 -07:00
openai.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
openllm.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
openlm.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
petals_example.ipynb fix(petals) allows to run models that aren't Bloom (Support for LLama and newer models) (#8356) 2023-07-27 18:01:04 -07:00
pipelineai_example.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
predibase.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
predictionguard.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
promptlayer_openai.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
rellm_experimental.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
replicate.ipynb Added stop sequence support to replicate (#8107) 2023-07-24 17:34:13 -07:00
runhouse.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
sagemaker.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
stochasticai.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
textgen.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
tongyi.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
writer.ipynb mv module integrations docs (#8101) 2023-07-23 23:23:16 -07:00
xinference.ipynb FEAT: Integrate Xinference LLMs and Embeddings (#8171) 2023-07-27 21:23:19 -07:00