Instructions to use nex-agi/Nex-N2.5-mini with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use nex-agi/Nex-N2.5-mini with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="nex-agi/Nex-N2.5-mini") 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("nex-agi/Nex-N2.5-mini") model = AutoModelForMultimodalLM.from_pretrained("nex-agi/Nex-N2.5-mini", 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 nex-agi/Nex-N2.5-mini with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "nex-agi/Nex-N2.5-mini" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "nex-agi/Nex-N2.5-mini", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/nex-agi/Nex-N2.5-mini
- SGLang
How to use nex-agi/Nex-N2.5-mini 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 "nex-agi/Nex-N2.5-mini" \ --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": "nex-agi/Nex-N2.5-mini", "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 "nex-agi/Nex-N2.5-mini" \ --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": "nex-agi/Nex-N2.5-mini", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use nex-agi/Nex-N2.5-mini with Docker Model Runner:
docker model run hf.co/nex-agi/Nex-N2.5-mini
💻 GitHub · 🤗 Hugging Face · 🌐 Website
Nex-N2.5
A next-generation family of agentic models built for long-horizon tasks in real-world environments.
Today, Nex-AGI officially introduces Nex-N2.5, its next-generation family of agentic models.
Nex-N2.5 is available in three sizes: mini, Pro, and Max. Nex-N2.5-mini and Nex-N2.5-Pro continue to build on the multimodal foundations of Nex-N2, with focused improvements in computer use, web browsing, and visually grounded agentic capabilities. Nex-N2.5-Max is built on a 1.6-trillion-parameter, text-only Mixture-of-Experts (MoE) foundation model, marking our first complete post-training effort at trillion-parameter scale.
For long-horizon tasks in real-world environments, Nex-N2.5 further strengthens its ability to act continuously and self-correct through visual feedback. The models can operate computers and browsers, as well as autonomously execute and test programs. Vision is therefore no longer merely an input modality; it has become a critical interface through which an agent perceives its environment, verifies outcomes, and moves a task forward.
Building on this foundation, we have further expanded the range of agent training environments, task types, and productivity scenarios, while completing systematic post-training at trillion-parameter scale for the first time. Through broader task coverage and richer environmental feedback, Nex-N2.5 delivers further gains in scientific research, knowledge work, and complex productivity tasks. This work also provides valuable practical experience for training agentic capabilities in even larger models.
By jointly advancing model training, infrastructure, and real-world agent scenarios, Nex-AGI aims to continue driving progress in agentic intelligence.
Open Source
Model weights for the Nex-N2.5 family will be released as open source, alongside hosted online services.
- Nex-N2.5-Max: Hugging Face | ModelScope
- Nex-N2.5-Pro: Hugging Face | ModelScope
- Nex-N2.5-mini: Hugging Face | ModelScope
- Hosted Access: OpenRouter (Nex-N2.5-Pro) | OpenRouter (Nex-N2.5-mini)
- Websites: Global
We welcome developers and enterprises to integrate and try Nex-N2.5 and share their feedback.
Performance
We evaluate Nex-N2.5 across coding, agentic workflows, computer use, and multimodal understanding.
The tables below compare Nex-N2.5-mini, Nex-N2.5-Pro, and Nex-N2.5-Max with leading models across our evaluation suite.1, 2 Bold marks the best result in each benchmark, including ties; — indicates unavailable data.10
Text Benchmarks
| Benchmark | Nex-N2.5-mini | Nex-N2.5-Pro | Nex-N2.5-Max | Claude Opus 5 | GPT-5.6 Sol | Kimi-K3 | GLM-5.3 | DeepSeek-V4-Pro-08134 | Qwen3.8-Max |
|---|---|---|---|---|---|---|---|---|---|
| CODING3 | |||||||||
| Terminal-Bench 2.1 | 73.4 | 82.7 | 86.1 | 89.1 | 88.8 | 88.3 | 88.2 | 87.9 | 86.6 |
| SWE-Bench Pro | 43.8 | 61.2 | 65.7 | 79.2 | 64.6 | 63.3 | 64.6 | 55.4 | 67.7 |
| DeepSWE v1.1 | 36.1 | 55.8 | 65.6 | 73.7 | 72.7 | 67.5 | 66.9 | 62.8 | 69.3 |
| AGENTIC | |||||||||
| AutomationBench v1.0.65 | 32.3 | 44.2 | 50.2 | 50.3 | 45.8 | 46.7 | 48.2 | 43.2 | 39.8 |
| Toolathlon Verified | 54.6 | 68.5 | 74.7 | 76.5 | 74.9 | 76.5 | 73.0 | 74.1 | 72.5 |
| GDPval-AA v2 | 1446 | 1628 | 1713 | 1831 | 1711 | 1675 | 1763 | 1580 | 1717 |
| Job Bench | 28.5 | 41.4 | 53.6 | 65.7 | 45.4 | 52.9 | 58.2 | 54.1 | 53.4 |
| BrowseComp6 | 83.4 | 89.7 | 92.6 | 90.8 | 90.4 | 91.2 | — | — | — |
Multimodal Benchmarks
| Benchmark | Nex-N2.5-mini | Nex-N2.5-Pro | MiniMax-M3 | Claude Opus 5 | GPT-5.6 Sol | Kimi-K3 | GLM-5.3-Flash | DeepSeek-V4-Flash-Vision | Qwen3.8-Max |
|---|---|---|---|---|---|---|---|---|---|
| OSWorld-Verified8 | 71.2 | 82.2 | 75.2 | 83.4 | 83.2 | 84.8 | 62.3 | 76.7 | 86.1 |
| OSWorld-2 | 30.5 | 56.4 | 22.3 | 68.3 | 62.7 | 58.3 | — | — | 46.7 |
| WebTest8, 9 | 48.6 | 52.8 | — | — | 54.0 | — | — | — | 52.3 |
| WebArena-Verified8 | 63.4 | 67.6 | — | — | 69.7 | 71.6 | — | 62.3 | 66.8 |
| OSWorld-G | 82.9 | 87.4 | — | 76.8 | 77.7 | 79.6 | 83.3 | 59.4 | 84.9 |
| Vision2Web7 | 52.9 | 68.2 | 59.0 | — | 79.8 | — | — | — | 75.1 |
| SWE-MM | 25.5 | 38.2 | — | 59.4 | 40.2 | 37.3 | 20.6 | 39.2 | 39.2 |
| OmniDoc | 89.7 | 92.2 | 91.6 | — | 92.9 | 91.1 | — | — | 92.1 |
1 Score sources: Where available, scores are drawn from official benchmark leaderboards and the latest evaluation reports published by model providers, including the Kimi-K3, Qwen3.8-Max, GLM-5.3, and HY4 reports. Results without a public source are obtained through our own evaluations.
2 Sampling parameters: Our evaluations use temperature = 0.7, top_p = 0.95, and top_k = 40.
3 Evaluation harness: Coding tasks are evaluated using the NexAU harness.
4 DeepSeek-V4-Pro: Our evaluations use the DeepSeek-V4-Pro-0813 version.
5 AutomationBench: We use the Public version.
6 BrowseComp: We apply the Summary context-compaction strategy when the token usage exceeds 60% of the model’s context window.
7 Vision2Web: We report the average score across the Frontend, Webpage, and Website categories, with Gemini-3.5-Flash as the VLM judge and GLM-5V-Turbo (Claude Code) as the GUI agent.
8 Computer-use and browser-use benchmarks, including OSWorld, WebTest, and WebArena, are evaluated using our NexCUA harness. Grounding coordinates are normalized to a 0–1000 scale. The NexCUA project will be open-sourced soon.
9 WebTestBench: These results are evaluated in oracle mode, using the ground-truth checklist to assess defect detection only, without checklist generation.
10 Notation: Bold marks the best result in each benchmark, including ties; — indicates unavailable data.
Usage
Docker Deployment
We also provide a prebuilt Docker image with our customized sglang fork preinstalled: nexagi/sglang:v0.5.18-nex-patch. The launch command is the same as above.
Nex-N2.5-Max
# Multi-node (2 nodes, 16 x H200). Run the same command on every node with:
# <node-rank> = 0 on the head node, 1 on the other node
# <node0-ip> = IP of the head node (reachable from all others)
docker run --gpus all --shm-size 32g --network host \
-v /path/to/your/model:/model \
nexagi/sglang:v0.5.18-nex-patch \
python3 -m sglang.launch_server \
--model-path /path/to/your/model \
--trust-remote-code \
--host 0.0.0.0 \
--port 8000 \
--nnodes 2 \
--node-rank "${NODE_RANK}" \
--dist-init-addr "${MASTER_ADDR}:5000" \
--tp 16 \
--pp-size 1 \
--dp 1 \
--ep-size 16 \
--attention-backend dsv4 \
--kv-cache-dtype fp8_e4m3 \
--page-size 256 \
--moe-a2a-backend deepep \
--moe-runner-backend deep_gemm \
--moe-dense-tp-size 1 \
--deepep-mode auto \
--context-length 262144 \
--mem-fraction-static 0.84 \
--chunked-prefill-size 8192 \
--enable-mixed-chunk \
--disable-overlap-schedule \
--max-running-requests 64 \
--cuda-graph-max-bs-decode 64 \
--cuda-graph-backend-decode full \
--cuda-graph-backend-prefill disabled \
--chat-template /path/to/nex-n2.5-max/chat_template.jinja \
--reasoning-parser deepseek-r1 \
--tool-call-parser qwen3_coder
Nex-N2.5-Pro
Single node with 8 × H100:
docker run --gpus all --shm-size 32g --ipc=host \
-p 30000:30000 \
-v /path/to/your/model:/model \
nexagi/sglang:v0.5.18-nex-patch \
python3 -m sglang.launch_server \
--model-path /model \
--tp 8 \
--host 0.0.0.0 --port 30000 \
--reasoning-parser qwen3 \
--tool-call-parser qwen3_coder \
--chat-template /path/to/nex-N2.5-Pro/chat-template.jinja \
--mamba-scheduler-strategy extra_buffer
Nex-N2.5-mini
Single node with 2 × H100:
docker run --gpus all --shm-size 32g --ipc=host \
-p 30000:30000 \
-v /path/to/your/model:/model \
nexagi/sglang:v0.5.18-nex-patch \
python3 -m sglang.launch_server \
--model-path /model \
--tp 2 \
--host 0.0.0.0 --port 30000 \
--reasoning-parser qwen3 \
--tool-call-parser qwen3_coder \
--chat-template /path/to/nex-N2.5-mini/chat-template.jinja \
--mamba-scheduler-strategy extra_buffer
Recommended Sampling Parameters
For the best generation quality, we recommend the following sampling parameters:
temperature: 0.7top_p: 0.95top_k: 40
Thinking Modes
Use reasoning_effort to control the thinking behavior of Nex-N2.5:
reasoning_effort |
Mode | Behavior |
|---|---|---|
"none" |
Non-thinking | Respond directly without a reasoning trace. |
"medium" (default) |
Adaptive thinking | Let the model decide whether and how much to think before responding. |
"high" |
Thinking | Always enable thinking before responding. |
For adaptive thinking, set reasoning_effort to "medium" in your OpenAI-compatible Chat Completions request. Replace <served-model-name> with the model name exposed by your server:
{
"model": "<served-model-name>",
"messages": [
{"role": "user", "content": "Explain how binary search works."}
],
"reasoning_effort": "medium"
}
The chat template uses reasoning_effort; parameters such as enable_thinking and thinking_mode require gateway-specific translation.
Function Calling
Nex-series models support robust function-calling capabilities. To enable function calling, add the --tool-call-parser qwen3_coder flag when launching the server:
python -m sglang.launch_server --model-path /path/to/your/model --tool-call-parser qwen3_coder
Reasoning Parser
When the model produces a reasoning trace, configure SGLang to separate it from the final response:
- Nex-N2.5-mini and Nex-N2.5-Pro:
--reasoning-parser qwen3 - Nex-N2.5-Max:
--reasoning-parser deepseek-r1
The deployment commands above include the appropriate reasoning parser and --tool-call-parser qwen3_coder. The parser extracts reasoning content; use reasoning_effort to select the thinking mode.
- Downloads last month
- 2
