Instructions to use openbmb/MiniCPM4-Survey with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use openbmb/MiniCPM4-Survey with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="openbmb/MiniCPM4-Survey", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("openbmb/MiniCPM4-Survey", trust_remote_code=True, dtype="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps
- vLLM
How to use openbmb/MiniCPM4-Survey with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "openbmb/MiniCPM4-Survey" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "openbmb/MiniCPM4-Survey", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/openbmb/MiniCPM4-Survey
- SGLang
How to use openbmb/MiniCPM4-Survey with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "openbmb/MiniCPM4-Survey" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "openbmb/MiniCPM4-Survey", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "openbmb/MiniCPM4-Survey" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "openbmb/MiniCPM4-Survey", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use openbmb/MiniCPM4-Survey with Docker Model Runner:
docker model run hf.co/openbmb/MiniCPM4-Survey
| import torch.distributed | |
| import faiss | |
| import pandas as pd | |
| import faiss | |
| import numpy as np | |
| import jsonlines, json | |
| from transformers import AutoModel | |
| import os | |
| import torch | |
| ''' | |
| data format: | |
| { | |
| "bibkey": "some_bibkey", | |
| "text": "The abstract or text of the paper." | |
| } | |
| example: | |
| { | |
| "bibkey": "arxivid1234.5678", | |
| "text": "Title: A Study on Something\nAbstract: This paper discusses the findings of a study on something important in the field of research.\nAuthors: John Doe" | |
| } | |
| ''' | |
| model_name = "openbmb/MiniCPM-Embedding-Light" | |
| model = AutoModel.from_pretrained(model_name, trust_remote_code=True, attn_implementation="flash_attention_2", torch_dtype=torch.float16).to("cuda") | |
| input_path = "./data/arxiv.jsonl" | |
| with jsonlines.open(input_path) as f: | |
| survey_data = list(f) | |
| xids = [item["bibkey"] for item in survey_data] | |
| passages = [item["text"] for item in survey_data] | |
| embeddings_doc_dense, _ = model.encode_corpus(passages, max_length=1024) | |
| # faiss save index | |
| index = faiss.IndexFlatIP(embeddings_doc_dense.shape[1]) | |
| id_map_index = faiss.IndexIDMap(index) | |
| index = faiss.index_cpu_to_all_gpus(id_map_index) | |
| x_ids_int = np.array(np.arange(len(xids))) | |
| str_int_ids = {} | |
| for i in range(len(xids)): | |
| str_int_ids[xids[i]] = x_ids_int[i] | |
| str_int_ids_df = pd.DataFrame(str_int_ids, index=[0]).T.reset_index() | |
| str_int_ids_df.columns = ["str_id", "int_id"] | |
| str_int_ids_df.to_csv("./index/str_int_ids_abstract.csv", index=False) | |
| index.add_with_ids(embeddings_doc_dense, x_ids_int) | |
| index = faiss.index_gpu_to_cpu(index) | |
| faiss.write_index(index, "./index/index_abstract.faiss") | |