Instructions to use mlx-community/Phi-3.5-MoE-instruct-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use mlx-community/Phi-3.5-MoE-instruct-4bit with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="mlx-community/Phi-3.5-MoE-instruct-4bit", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("mlx-community/Phi-3.5-MoE-instruct-4bit", trust_remote_code=True) model = AutoModelForCausalLM.from_pretrained("mlx-community/Phi-3.5-MoE-instruct-4bit", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - MLX
How to use mlx-community/Phi-3.5-MoE-instruct-4bit with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("mlx-community/Phi-3.5-MoE-instruct-4bit") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Notebooks
- Google Colab
- Kaggle
- Local Apps
- LM Studio
- vLLM
How to use mlx-community/Phi-3.5-MoE-instruct-4bit with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "mlx-community/Phi-3.5-MoE-instruct-4bit" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "mlx-community/Phi-3.5-MoE-instruct-4bit", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/mlx-community/Phi-3.5-MoE-instruct-4bit
- SGLang
How to use mlx-community/Phi-3.5-MoE-instruct-4bit 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 "mlx-community/Phi-3.5-MoE-instruct-4bit" \ --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": "mlx-community/Phi-3.5-MoE-instruct-4bit", "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 "mlx-community/Phi-3.5-MoE-instruct-4bit" \ --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": "mlx-community/Phi-3.5-MoE-instruct-4bit", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - MLX LM
How to use mlx-community/Phi-3.5-MoE-instruct-4bit with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "mlx-community/Phi-3.5-MoE-instruct-4bit"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "mlx-community/Phi-3.5-MoE-instruct-4bit" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "mlx-community/Phi-3.5-MoE-instruct-4bit", "messages": [ {"role": "user", "content": "Hello"} ] }' - Docker Model Runner
How to use mlx-community/Phi-3.5-MoE-instruct-4bit with Docker Model Runner:
docker model run hf.co/mlx-community/Phi-3.5-MoE-instruct-4bit
[WIP] Upload folder using huggingface_hub (multi-commit 5afa1f6bd3881eb72a0c08f7e20961d3ba57f20629f4efb12a7007b788c43bfa)
Upload folder using huggingface_hub
Multi commit ID: 5afa1f6bd3881eb72a0c08f7e20961d3ba57f20629f4efb12a7007b788c43bfa
Scheduled commits:
- Upload 1 file(s) totalling 5.2G (83a2f3b20e8a4d1c57b3f7854e8cf1434d1103b0c7a0d85b84b4190bbc68e9cc)
- Upload 1 file(s) totalling 5.4G (e8e6faed7d6dfa51798b05143a2ef8e3a32a27b0bc720d633abeef7547867ac1)
- Upload 1 file(s) totalling 5.4G (4bdbe4ed4c3f779586814f6185da250bc2dd49d18d771394069456f059f2fb8d)
- Upload 1 file(s) totalling 5.4G (b95eb652cf27f3b97dba11ae009d21ab72a735cfc6da7a1b4925737c94053c06)
- Upload 1 file(s) totalling 2.3G (20f28f7f4432d5703ce0ab546a1612cbb74a08154dbd32ae78ca79b15ef28e06)
- Upload 11 file(s) totalling 2.6M (d74c6be482305de73cc91043f7cc48c654fe4978ea8af12a0a5e0173475563f5)
This is a PR opened using the huggingface_hub library in the context of a multi-commit. PR can be commented as a usual PR. However, please be aware that manually updating the PR description, changing the PR status, or pushing new commits, is not recommended as it might corrupt the commit process. Learn more about multi-commits in this guide.