Instructions to use stabilityai/StableBeluga2 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use stabilityai/StableBeluga2 with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="stabilityai/StableBeluga2")

# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("stabilityai/StableBeluga2")
model = AutoModelForCausalLM.from_pretrained("stabilityai/StableBeluga2")

Notebooks
Google Colab
Kaggle
Local Apps Settings

vLLM

How to use stabilityai/StableBeluga2 with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "stabilityai/StableBeluga2"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "stabilityai/StableBeluga2",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

Use Docker

docker model run hf.co/stabilityai/StableBeluga2

SGLang

How to use stabilityai/StableBeluga2 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 "stabilityai/StableBeluga2" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "stabilityai/StableBeluga2",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

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 "stabilityai/StableBeluga2" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "stabilityai/StableBeluga2",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

Docker Model Runner
How to use stabilityai/StableBeluga2 with Docker Model Runner:
```
docker model run hf.co/stabilityai/StableBeluga2
```

dmayhem93 commited on Jul 27, 2023

Commit

3b77dcd

1 Parent(s): 863ba93

Update README.md

Browse files

Files changed (1) hide show

README.md +5 -5

README.md CHANGED Viewed

@@ -22,9 +22,9 @@ Start chatting with `Stable Beluga 2` using the following code snippet:
 import torch
 from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline
-tokenizer = AutoTokenizer.from_pretrained("stabilityai/FreeWilly2", use_fast=False)
-model = AutoModelForCausalLM.from_pretrained("stabilityai/FreeWilly2", torch_dtype=torch.float16, low_cpu_mem_usage=True, device_map="auto")
-system_prompt = "### System:\nYou are Free Willy, an AI that follows instructions extremely well. Help as much as you can. Remember, be safe, and don't do anything illegal.\n\n"
 message = "Write me a poem please"
 prompt = f"{system_prompt}### User: {message}\n\n### Assistant:\n"
@@ -34,7 +34,7 @@ output = model.generate(**inputs, do_sample=True, top_p=0.95, top_k=0, max_new_t
 print(tokenizer.decode(output[0], skip_special_tokens=True))
 ```
-FreeWilly should be used with this prompt format:
 ```
 ### System:
 This is a system prompt, please behave and help the user.
@@ -42,7 +42,7 @@ This is a system prompt, please behave and help the user.
 ### User:
 Your prompt here
-### Assistant
 The output of Stable Beluga 2
 ```

 import torch
 from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline
+tokenizer = AutoTokenizer.from_pretrained("stabilityai/StableBeluga2", use_fast=False)
+model = AutoModelForCausalLM.from_pretrained("stabilityai/StableBeluga2", torch_dtype=torch.float16, low_cpu_mem_usage=True, device_map="auto")
+system_prompt = "### System:\nYou are Stable Beluga, an AI that follows instructions extremely well. Help as much as you can. Remember, be safe, and don't do anything illegal.\n\n"
 message = "Write me a poem please"
 prompt = f"{system_prompt}### User: {message}\n\n### Assistant:\n"
 print(tokenizer.decode(output[0], skip_special_tokens=True))
 ```
+Stable Beluga 2 should be used with this prompt format:
 ```
 ### System:
 This is a system prompt, please behave and help the user.
 ### User:
 Your prompt here
+### Assistant:
 The output of Stable Beluga 2
 ```