Text Generation
Transformers
Safetensors
English
qwen2
routing
preference
llm
conversational
text-generation-inference
Instructions to use katanemo/Arch-Router-1.5B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use katanemo/Arch-Router-1.5B with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="katanemo/Arch-Router-1.5B") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("katanemo/Arch-Router-1.5B") model = AutoModelForCausalLM.from_pretrained("katanemo/Arch-Router-1.5B") 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]:])) - Inference
- Local Apps Settings
- vLLM
How to use katanemo/Arch-Router-1.5B with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "katanemo/Arch-Router-1.5B" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "katanemo/Arch-Router-1.5B", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/katanemo/Arch-Router-1.5B
- SGLang
How to use katanemo/Arch-Router-1.5B 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 "katanemo/Arch-Router-1.5B" \ --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": "katanemo/Arch-Router-1.5B", "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 "katanemo/Arch-Router-1.5B" \ --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": "katanemo/Arch-Router-1.5B", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use katanemo/Arch-Router-1.5B with Docker Model Runner:
docker model run hf.co/katanemo/Arch-Router-1.5B
Update README.md
Browse files
README.md
CHANGED
|
@@ -14,15 +14,11 @@ library_name: transformers
|
|
| 14 |
# katanemo/Arch-Router-1.5B
|
| 15 |
|
| 16 |
## Overview
|
| 17 |
-
With the rapid proliferation of large language models (LLMs) -- each optimized for different strengths, style, or latency/cost profile -- routing has become an essential technique to operationalize the use of different models.
|
| 18 |
|
| 19 |
-
|
| 20 |
-
We introduce a preference-aligned routing framework that guides model selection by matching queries to user-defined domains (e.g., travel) or action types (e.g., image editing) -- offering a practical mechanism to encode preferences in routing decisions.
|
| 21 |
-
Specifically, we introduce Arch-Router, a compact 1.5B model that learns to map queries to domain-action preferences for model routing decisions.
|
| 22 |
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
Arch-Router powers [Arch](https://github.com/katanemo/arch) the open-source AI-native proxy for agents and enables seamless, preference-based routing in multi-LLM systems.
|
| 26 |
|
| 27 |
### How It Works
|
| 28 |
|
|
@@ -39,8 +35,6 @@ Both domain and action configs are associated with preferred models or model var
|
|
| 39 |
- **Flexible and Adaptive**: Supports evolving user needs, model updates, and new domains/actions without retraining the router.
|
| 40 |
- **Production-Ready Performance**: Optimized for low-latency, high-throughput applications in multi-model environments.
|
| 41 |
|
| 42 |
-
Arch-Router powers [Arch](https://github.com/katanemo/arch) the open-source AI-native proxy for agents and enables seamless, preference-based routing in multi-LLM systems.
|
| 43 |
-
|
| 44 |
# Requirements
|
| 45 |
The code of Arch-Router-1.5B has been in the Hugging Face `transformers` library and we advise you to install latest version:
|
| 46 |
```bash
|
|
|
|
| 14 |
# katanemo/Arch-Router-1.5B
|
| 15 |
|
| 16 |
## Overview
|
| 17 |
+
With the rapid proliferation of large language models (LLMs) -- each optimized for different strengths, style, or latency/cost profile -- routing has become an essential technique to operationalize the use of different models. However, existing LLM routing approaches are limited in two key ways: they evaluate performance using benchmarks that often fail to capture human preferences driven by subjective evaluation criteria, and they typically select from a limited pool of models.
|
| 18 |
|
| 19 |
+
We introduce a preference-aligned routing framework that guides model selection by matching queries to user-defined domains (e.g., travel) or action types (e.g., image editing) -- offering a practical mechanism to encode preferences in routing decisions. Specifically, we introduce Arch-Router, a compact 1.5B model that learns to map queries to domain-action preferences for model routing decisions. Experiments on conversational datasets demonstrate that our approach achieves state-of-the-art (SOTA) results in matching queries with human preferences, outperforming top proprietary models.
|
|
|
|
|
|
|
| 20 |
|
| 21 |
+
Arch-Router powers [Arch](https://github.com/katanemo/arch) the open-source AI-native proxy for agents to enable preference-based routing in multi-LLM systems in a seamless way.
|
|
|
|
|
|
|
| 22 |
|
| 23 |
### How It Works
|
| 24 |
|
|
|
|
| 35 |
- **Flexible and Adaptive**: Supports evolving user needs, model updates, and new domains/actions without retraining the router.
|
| 36 |
- **Production-Ready Performance**: Optimized for low-latency, high-throughput applications in multi-model environments.
|
| 37 |
|
|
|
|
|
|
|
| 38 |
# Requirements
|
| 39 |
The code of Arch-Router-1.5B has been in the Hugging Face `transformers` library and we advise you to install latest version:
|
| 40 |
```bash
|