Instructions to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 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 sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0 # Run inference directly in the terminal: llama cli -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0 # Run inference directly in the terminal: llama cli -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
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 sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0 # Run inference directly in the terminal: ./llama-cli -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
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 sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
Use Docker
docker model run hf.co/sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
- LM Studio
- Jan
- Ollama
How to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 with Ollama:
ollama run hf.co/sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
- Unsloth Desktop
- Pi
How to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 with Docker Model Runner:
docker model run hf.co/sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
- Lemonade
How to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
Run and chat with the model
lemonade run user.Qwen3-4B-Feiyue-v1-Q8_0-Q8_0
List all available models
lemonade list
- Hermes Agent
How to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
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 sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
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 "sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0" \ --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"
Start the llama.cpp server
# Install llama.cpp:
brew install llama.cpp# Start a local OpenAI-compatible server:
llama serve -hf sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0Configure 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 "sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0" \
--custom-provider-id llama-cpp \
--custom-compatibility openai \
--custom-text-input \
--accept-risk \
--skip-healthRun OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"Qwen3-4B-Feiyue-v1-Q8_0 โญ
Overview
Q8_0 quantized GGUF โ the recommended deployment format for Feiyue-v1. Near-lossless quality in a compact 8-bit package, optimized for RTX 5060 (8 GB VRAM) with full 8K context.
| Property | Value |
|---|---|
| Base Model | Qwen/Qwen3-4B-Instruct-2507 |
| Quant Method | Q8_0 (8-bit, GGUF) |
| File Size | ~4.3 GB |
| VRAM (8K ctx) | ~5.5 GB |
| License | Apache 2.0 |
Core Capabilities
- PRD Generation โ Full fidelity, hierarchical task decomposition preserved
- Code Review โ All quality retained from bf16
- Tool-calling โ Near-lossless, production-ready
Quantization Quality
| Capability | Q8_0 | Q4_K_M | Notes |
|---|---|---|---|
| PRD Generation | โ 98%+ | โ ๏ธ 50% | Q8 retains full logical structure |
| Code Review | โ 98%+ | โ 70% | Both functional; Q8 more nuanced |
| Tool-calling | โ 99% | โ ๏ธ 70% | Q8 strongly recommended for agents |
โ Production recommendation: Q8_0 on RTX 5060 (8 GB) with 8K context.
System Requirements
| GPU VRAM | Max Context | Feasible |
|---|---|---|
| 8 GB | 8,192 | โ Recommended |
| 6 GB | 4,096 | โ Works |
| 4 GB | 2,048 | โ ๏ธ Tight |
๐ฆ Ollama Deployment (Recommended)
Ollama is the simplest way to run Feiyue-v1 on Windows, macOS, or Linux.
Quick Start
# Pull and run directly from HuggingFace
ollama run hf.co/sinonchum/Qwen3-4B-Feiyue-v1-Q8_0
# Or with explicit quant tag
ollama run hf.co/sinonchum/Qwen3-4B-Feiyue-v1-Q8_0:Q8_0
Custom Modelfile (Persistent Setup)
Create a Modelfile for full control over system prompt, temperature, and context:
FROM Qwen3-4B-Feiyue-v1-Q8_0.gguf
PARAMETER temperature 0.7
PARAMETER num_ctx 8192
TEMPLATE """{ if .System }<|im_start|>system
{ .System }<|im_end|>
{ end }{ if .Prompt }<|im_start|>user
{ .Prompt }<|im_end|>
{ end }<|im_start|>assistant
{ .Response }<|im_end|>"""
SYSTEM """You are Feiyue, an AI agent specialized in PRD generation, code review, and tool calling."""
Build and run:
# Save Modelfile, then:
ollama create feiyue-q8 -f Modelfile
ollama run feiyue-q8
Windows Notes
- Install Ollama from ollama.com/download/windows
- Place the
.gguffile inC:\Users\<yourname>\.ollama\models\for local use - For GPU acceleration on Windows, ensure NVIDIA drivers โฅ 526.x and CUDA โฅ 11.8
- RTX 5060 (8 GB VRAM) with 5.5 GB GGUF: comfortable with 8192 context
- To set model directory:
set OLLAMA_MODELS=C:\path\to\models(CMD) or$env:OLLAMA_MODELS="C:\path\to\models"(PowerShell)
Ollama API (Programmatic Access)
import requests
response = requests.post("http://localhost:11434/api/chat", json={
"model": "feiyue-q8",
"messages": [
{"role": "system", "content": "You are Feiyue, an AI agent."},
{"role": "user", "content": "Review this code for SQL injection vulnerabilities."},
],
"stream": False,
"options": {"temperature": 0.7, "num_ctx": 8192},
})
print(response.json()["message"]["content"])
llama.cpp Usage
huggingface-cli download sinonchum/Qwen3-4B-Feiyue-v1-Q8_0 Qwen3-4B-Feiyue-v1-Q8_0.gguf --local-dir .
./llama-cli \
-m Qwen3-4B-Feiyue-v1-Q8_0.gguf \
-c 8192 -ngl 99 --temp 0.7 \
--chat-template chatml \
-p "You are Feiyue, an AI agent."
Python (llama-cpp-python)
from llama_cpp import Llama
llm = Llama.from_pretrained(
repo_id="sinonchum/Qwen3-4B-Feiyue-v1-Q8_0",
filename="Qwen3-4B-Feiyue-v1-Q8_0.gguf",
)
llm.create_chat_completion(
messages=[{"role": "user", "content": "Review this code for security issues."}]
)
Training Summary
See sinonchum/Qwen3-4B-Feiyue-v1-bf16 for full training details.
Related Models
- bf16 Merged โ Full precision
- Adapter โ LoRA weights
- Q4_K_M โ 4-bit compact variant
- Downloads last month
- -
8-bit
Model tree for sinonchum/Qwen3-4B-Feiyue-v1-Q8_0
Base model
Qwen/Qwen3-4B-Instruct-2507
# Gated model: Login with a HF token with gated access permission hf auth login