Instructions to use Junhauwong/Surge-V1-Pro with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Junhauwong/Surge-V1-Pro with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="Junhauwong/Surge-V1-Pro") 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)# Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("Junhauwong/Surge-V1-Pro") model = AutoModelForMultimodalLM.from_pretrained("Junhauwong/Surge-V1-Pro", device_map="auto") 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?"} ] }, ] inputs = processor.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(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use Junhauwong/Surge-V1-Pro with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Junhauwong/Surge-V1-Pro" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Junhauwong/Surge-V1-Pro", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/Junhauwong/Surge-V1-Pro
- SGLang
How to use Junhauwong/Surge-V1-Pro 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 "Junhauwong/Surge-V1-Pro" \ --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": "Junhauwong/Surge-V1-Pro", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'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 "Junhauwong/Surge-V1-Pro" \ --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": "Junhauwong/Surge-V1-Pro", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Docker Model Runner
How to use Junhauwong/Surge-V1-Pro with Docker Model Runner:
docker model run hf.co/Junhauwong/Surge-V1-Pro
📊 Surge Benchmark Results
Measured and calculated results across reasoning, coding, mathematics, document understanding, vision, multimodal, and agentic tasks.
General, Reasoning & Coding
This section covers general knowledge, advanced reasoning, competitive programming, software engineering, terminal agents, instruction following, and professional task performance.
| Benchmark / Task | Score |
|---|---|
| GPQA Diamond | 89.2 |
| HLE | 30.8 |
| Terminal-Bench 2.1 | 73.0 |
| SWE-bench Pro | 61.7 |
| DeepSWE 1.1 | 42.2 |
| LiveCodeBench v6 | 90.3 |
| QwenSWEBench | 79.0 |
| CoWorkBench | 70.7 |
| JobBench | 33.4 |
| IFBench | 79.5 |
| MMLU-Pro Selected Subset | 87.43 |
| SWE-bench Verified | 71.13 |
| Web Design Validation | 100.0 |
✨ Highlights
- 90.3 on LiveCodeBench v6
- 89.2 on GPQA Diamond
- 87.43 on the selected MMLU-Pro subset
- 79.0 on QwenSWEBench
- 73.0 on Terminal-Bench 2.1
- 71.13 on SWE-bench Verified
- 100.0 on Web Design Validation
Fable & Kiwen Benchmarks
| Benchmark / Task | Score |
|---|---|
| ARC Challenge | 61.40 |
| ARC Challenge Easy | 80.70 |
| BoolQ | 90.35 |
| GSM8K Strict | 81.90 |
| GSM8K Flexible | 85.80 |
| IFEval Prompt Strict | 82.15 |
| IFEval Instruction Strict | 85.00 |
| IFEval Prompt Loose | 85.20 |
| IFEval Instruction Loose | 87.00 |
| VMLU Validation | 84.15 |
Surge reaches 90.35 on BoolQ and 85.80 on GSM8K Flexible.
Extraction & Document Understanding
| Benchmark / Task | Score |
|---|---|
| ExtractBench Mean | 89.75 |
| ExtractBench Short | 94.68 |
| ExtractBench Medium | 87.54 |
| ExtractBench Long | 38.45 |
| ParseBench Mean | 70.79 |
| ParseBench Text Content | 88.28 |
| ParseBench Text Formatting | 59.77 |
| ParseBench Layout | 69.90 |
| ParseBench Chart | 69.17 |
| ParseBench Table | 66.82 |
Surge performs particularly well on short and medium-length extraction. Long-document extraction remains more challenging, with 38.45 on ExtractBench Long.
Vision & Multimodal
| Benchmark / Task | Score |
|---|---|
| Claw-Eval Multimodal | 57.4 |
| WildClawBench Overall | 48.02 |
| OSWorld-Verified | 84.3 |
| WebArena-Verified | 64.8 |
| AndroidWorld | 81.9 |
| RecreationBench | 47.1 |
| ClawEval-MM Pass@3 | 57.4 |
| SWE-MM | 38.6 |
| Vision2Web | 62.9 |
| MathVision — without CI | 90.0 |
| MathVision — with CI | 94.6 |
| BabyVision — without CI | 65.7 |
| BabyVision — with CI | 85.6 |
| CharXiv RQ — without CI | 83.7 |
| CharXiv RQ — with CI | 90.2 |
| OmniDocBench 1.5 | 91.1 |
| RealWorldQA | 85.9 |
| ERQA | 65.5 |
Directly Averaged Source References
| Benchmark | Score |
|---|---|
| GSM8K Strict | 81.90 |
| GSM8K Flexible | 85.80 |
| ARC Challenge | 61.40 |
| ARC Challenge Easy | 80.70 |
| BoolQ | 90.35 |
| SWE-bench Verified | 71.13 |
Capability Sources
| Component | Primary Capability |
|---|---|
| Base | General knowledge, vision, and multimodal tasks |
| Fable | Reasoning and chain-of-thought |
| Kiwen | Mathematics, GSM8K, instruction following, and tools |
| Salience | Engineering, debugging, and vision |
| Coder | Repository-level coding and tool use |
| Qwopus v2 | Advanced reasoning and MMLU-Pro |
| Qwythos | Terminal agents, function calling, and long-context reasoning |
Benchmark Summary
| Capability | Notable Result |
|---|---|
| Advanced Reasoning | GPQA Diamond — 89.2 |
| Coding | LiveCodeBench v6 — 90.3 |
| Software Engineering | SWE-bench Verified — 71.13 |
| Terminal Agent | Terminal-Bench 2.1 — 73.0 |
| General Knowledge / Reasoning | MMLU-Pro Selected Subset — 87.43 |
| Mathematics | GSM8K Flexible — 85.80 |
| Instruction Following | IFEval Instruction Loose — 87.00 |
| Extraction | ExtractBench Mean — 89.75 |
| Document Understanding | OmniDocBench 1.5 — 91.1 |
| Visual Mathematics | MathVision with CI — 94.6 |
| Computer Use | OSWorld-Verified — 84.3 |
| Android Agent | AndroidWorld — 81.9 |
Evaluation Disclaimer
Benchmark results should be interpreted in the context of their exact evaluation methodology.
- benchmark and dataset version;
- evaluation harness;
- system prompt and chat template;
- sampling and decoding parameters;
- tool availability;
- context length;
- number of attempts or Pass@k configuration;
- CI or auxiliary evaluation conditions;
- benchmark subsets;
- model quantization and inference configuration.
Comparisons with other models should use matching benchmark versions and evaluation settings wherever possible.
- Downloads last month
- 16