Instructions to use Shumatsurontek/Qwen3.5-4B-neo with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Shumatsurontek/Qwen3.5-4B-neo with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="Shumatsurontek/Qwen3.5-4B-neo") 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("Shumatsurontek/Qwen3.5-4B-neo") model = AutoModelForMultimodalLM.from_pretrained("Shumatsurontek/Qwen3.5-4B-neo", 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
- llama.cpp
How to use Shumatsurontek/Qwen3.5-4B-neo with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf Shumatsurontek/Qwen3.5-4B-neo # Run inference directly in the terminal: llama cli -hf Shumatsurontek/Qwen3.5-4B-neo
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Shumatsurontek/Qwen3.5-4B-neo # Run inference directly in the terminal: llama cli -hf Shumatsurontek/Qwen3.5-4B-neo
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf Shumatsurontek/Qwen3.5-4B-neo # Run inference directly in the terminal: ./llama-cli -hf Shumatsurontek/Qwen3.5-4B-neo
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf Shumatsurontek/Qwen3.5-4B-neo # Run inference directly in the terminal: ./build/bin/llama-cli -hf Shumatsurontek/Qwen3.5-4B-neo
Use Docker
docker model run hf.co/Shumatsurontek/Qwen3.5-4B-neo
- LM Studio
- Jan
- vLLM
How to use Shumatsurontek/Qwen3.5-4B-neo with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Shumatsurontek/Qwen3.5-4B-neo" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Shumatsurontek/Qwen3.5-4B-neo", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Shumatsurontek/Qwen3.5-4B-neo
- SGLang
How to use Shumatsurontek/Qwen3.5-4B-neo 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 "Shumatsurontek/Qwen3.5-4B-neo" \ --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": "Shumatsurontek/Qwen3.5-4B-neo", "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 "Shumatsurontek/Qwen3.5-4B-neo" \ --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": "Shumatsurontek/Qwen3.5-4B-neo", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Ollama
How to use Shumatsurontek/Qwen3.5-4B-neo with Ollama:
ollama run hf.co/Shumatsurontek/Qwen3.5-4B-neo
- Unsloth Studio
How to use Shumatsurontek/Qwen3.5-4B-neo with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Shumatsurontek/Qwen3.5-4B-neo to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Shumatsurontek/Qwen3.5-4B-neo to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Shumatsurontek/Qwen3.5-4B-neo to start chatting
- Pi
How to use Shumatsurontek/Qwen3.5-4B-neo with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Shumatsurontek/Qwen3.5-4B-neo
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "Shumatsurontek/Qwen3.5-4B-neo" } ] } } }Run Pi
# Start Pi in your project directory: pi
- OpenClaw new
How to use Shumatsurontek/Qwen3.5-4B-neo with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Shumatsurontek/Qwen3.5-4B-neo
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "Shumatsurontek/Qwen3.5-4B-neo" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
- Docker Model Runner
How to use Shumatsurontek/Qwen3.5-4B-neo with Docker Model Runner:
docker model run hf.co/Shumatsurontek/Qwen3.5-4B-neo
- Lemonade
How to use Shumatsurontek/Qwen3.5-4B-neo with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Shumatsurontek/Qwen3.5-4B-neo
Run and chat with the model
lemonade run user.Qwen3.5-4B-neo-{{QUANT_TAG}}List all available models
lemonade list
- Hermes Agent
How to use Shumatsurontek/Qwen3.5-4B-neo with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Shumatsurontek/Qwen3.5-4B-neo
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default Shumatsurontek/Qwen3.5-4B-neo
Run Hermes
hermes
- Atomic Chat
Overview
This model was fine-tuned from unsloth/Qwen3.5-4B on the
Shumatsurontek/neo-sql-reasoning-combined dataset using Supervised Fine-Tuning (SFT)
with LoRA adapters (merged into base weights for easy deployment).
- Developed by: Shumatsurontek
- Fine-tuning pipeline: neo-deep-agent-lab
- Engine: Unsloth
- Compute: NVIDIA L40S on Modal serverless GPUs
- Precision: bf16
- License: Apache 2.0
Training Details
Configuration
| Parameter | Value |
|---|---|
| Base model | unsloth/Qwen3.5-4B |
| Method | SFT + LoRA (bf16, merged) |
| Learning rate | 2e-04 (cosine schedule, 5% warmup) |
| LoRA rank (r) | 16 |
| LoRA alpha | 32 (α/r = 32/16) |
| Batch size | 4 per GPU |
| Max sequence length | 2048 |
| Epochs | 2 |
Hyperparameters
Results
| Metric | Value |
|---|---|
| Final training loss | 0.5880 |
| Total optimization steps | 1,914 |
| Warmup | 5% (linear) |
| LR scheduler | cosine → 0 |
| Optimizer | AdamW 8-bit |
Dataset
Shumatsurontek/neo-sql-reasoning-combined
Each sample follows a 3-turn chat format:
System: You are a SQL expert. Given a database schema and a
natural language question, generate the correct SQL query.
User: Schema: CREATE TABLE orders (id INT, total DECIMAL);
Question: What is the total revenue?
Assistant: SELECT SUM(total) FROM orders;
Quickstart
Transformers
from transformers import AutoModelForCausalLM, AutoTokenizer
model = AutoModelForCausalLM.from_pretrained("Shumatsurontek/Qwen3.5-4B-neo")
tokenizer = AutoTokenizer.from_pretrained("Shumatsurontek/Qwen3.5-4B-neo")
messages = [
{"role": "system", "content": "You are a SQL expert. Given a database schema and a natural language question, generate the correct SQL query."},
{"role": "user", "content": "Schema: CREATE TABLE orders (id INT, user_id INT, total DECIMAL);\nQuestion: Total revenue per user?"},
]
text = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
inputs = tokenizer(text, return_tensors="pt").to(model.device)
output = model.generate(**inputs, max_new_tokens=256)
print(tokenizer.decode(output[0], skip_special_tokens=True))
vLLM (OpenAI-compatible server)
vllm serve Shumatsurontek/Qwen3.5-4B-neo --trust-remote-code
curl http://localhost:8000/v1/chat/completions -H "Content-Type: application/json" -d '{
"model": "Shumatsurontek/Qwen3.5-4B-neo",
"messages": [
{"role": "system", "content": "You are a SQL expert."},
{"role": "user", "content": "Schema: CREATE TABLE users (id INT, name TEXT);\nQuestion: List all users?"}
]
}'
Intended Use
This model is designed for text-to-SQL tasks: given a database schema and a natural-language question, it generates the corresponding SQL query. Best suited for analytical and read-only queries.
Out of scope: DDL/DML generation (CREATE, DROP, INSERT, UPDATE, DELETE), multi-database queries, or production use without human review of generated SQL.
Benchmark Results
Evaluated against baseline unsloth/Qwen3.5-4B using lm-eval-harness on NVIDIA L40S.
Evaluated on 50 samples per task.
| Benchmark | Baseline | Finetuned | Delta |
|---|---|---|---|
| MMLU: STEM | 73.5 | 71.8 | 🔴 -1.7 |
| MMLU: HUMANITIES | 76.5 | 73.4 | 🔴 -3.1 |
| HELLASWAG | 48.0 | 52.0 | 🟢 +4.0 |
| MMLU | 77.1 | 74.7 | 🔴 -2.4 |
| MMLU: OTHER | 77.7 | 75.8 | 🔴 -1.8 |
| ARC_CHALLENGE | 60.0 | 60.0 | ⚪ 0.0 |
| MMLU: SOCIAL SCIENCES | 83.0 | 79.7 | 🔴 -3.3 |
Citation
@misc{Qwen3_5_4B_neo,
title = {Qwen3.5-4B-neo},
author = {Shumatsurontek},
year = {2026},
url = {https://huggingface.co/Shumatsurontek/Qwen3.5-4B-neo}
}
License
Apache 2.0
- Downloads last month
- 30
Model tree for Shumatsurontek/Qwen3.5-4B-neo
Dataset used to train Shumatsurontek/Qwen3.5-4B-neo
Evaluation results
- Training Loss on Shumatsurontek/neo-sql-reasoning-combinedself-reported0.588