Instructions to use ServiceNow-AI/SuperApriel-15B-Instruct with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use ServiceNow-AI/SuperApriel-15B-Instruct with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="ServiceNow-AI/SuperApriel-15B-Instruct", trust_remote_code=True) messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoModelForImageTextToText model = AutoModelForImageTextToText.from_pretrained("ServiceNow-AI/SuperApriel-15B-Instruct", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use ServiceNow-AI/SuperApriel-15B-Instruct with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ServiceNow-AI/SuperApriel-15B-Instruct" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ServiceNow-AI/SuperApriel-15B-Instruct", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/ServiceNow-AI/SuperApriel-15B-Instruct
- SGLang
How to use ServiceNow-AI/SuperApriel-15B-Instruct 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 "ServiceNow-AI/SuperApriel-15B-Instruct" \ --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": "ServiceNow-AI/SuperApriel-15B-Instruct", "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 "ServiceNow-AI/SuperApriel-15B-Instruct" \ --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": "ServiceNow-AI/SuperApriel-15B-Instruct", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use ServiceNow-AI/SuperApriel-15B-Instruct with Docker Model Runner:
docker model run hf.co/ServiceNow-AI/SuperApriel-15B-Instruct
Commit History
-
report link
7012e86 -
eprint
8925af8
-
updated results
3ec808b
-
Add note about vLLM pure-recurrent placement limitation
Custom placements using only GDN/KDA mixers (no FA or SWA) are not supported due to a vLLM KV cache coordinator constraint. All shipped presets include attention-type layers and are unaffected. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>da9a2d8 -
Update speedup numbers in tables from paper
Throughput measurements updated to match paper (tab:s2v2_full): - @32k: e.g. Reg|Lklhd-10 9.9× → 10.69×, Idealized|Lklhd-6 5.7× → 6.2× - @16k: e.g. Reg|Lklhd-10 6.5× → 4.2×, Reg|Lklhd-26 2.4× → 1.5× - External models: Falcon-H1R 4.2× → 4.61×, Nemotron-Nano 5.4× → 5.85×, etc. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>9c39f06
-
Update Fast-LLM vLLM plugin branch reference
Branch renamed: oo/feature/vllm-apriel2-model-modeling → feature/vllm-apriel2-models Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>31fd523 -
Add vLLM serving section with OpenAI-compatible API examples
Tested with vllm serve CLI. Includes preset selection before launch, curl example, and OpenAI Python client example. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>25bc346
-
Add Transformers support with AutoModelForCausalLM and preset selection
- Add AutoModelForCausalLM to auto_map in all config.json files (main + 9 presets) - Add config_class = Apriel2Config to Apriel2ForCausalLM for compatibility - Add Apriel2PatternMixerAdapter to match supernet checkpoint weight paths (blocks.{i}.mixer.mixers.{type}.{param}) when loading pattern preset configs - Update README: move Transformers section after vLLM, add install deps, document preset selection workflow with config.json copy Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>6b09478 -
Address reviewer feedback on README
- Tone down Highlights section, point to report for details - Remove "key advantage" promotional sentence - Remove untested temperature recommendation, point to Apriel 1.6 - Fix citation bibtex key (2025 -> 2026) - Fix vLLM plugin link to point to branch/subfolder - Pin vLLM to 0.14.1 (tested version) - Clarify GPU memory table columns - Add per-request preset switching description Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>472a888
-
Pin vLLM version to 0.15.1 (tested version)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>136311d -
Fix tilde rendering in vLLM section (avoid markdown strikethrough)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>3f2bdcd -
Add TODO placeholder for per-request preset selection API
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>5ef0391 -
Add vLLM serving instructions with preset selection and runtime switching
Replace TODO placeholders in the vLLM section with tested instructions: - Standalone plugin installation (no full Fast-LLM dependency) - Single-preset mode: config swap, single GPU (~27 GiB) - Supernet mode: runtime switching via collective_rpc (~3-20ms) - GPU memory reference table for 1-GPU and 2-GPU setups Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>07563d8 -
Remove .DS_Store and add to .gitignore
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>c384df8 -
Add preset placement configs with paper-matching names
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>99684b3
-
Optimize logo image size (1.5MB -> 41KB)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>89275ae -
Add model card for SuperApriel-15b-Instruct
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>86ad99a
-
Upload folder using huggingface_hub
Verified signature7925509 -
initial commit
Verified signature41a56a9