How to use from
OpenClaw
# Gated model: Login with a HF token with gated access permission
hf auth login
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"
Quick Links

You need to agree to share your contact information to access this model

This repository is publicly accessible, but you have to accept the conditions to access its files and content.

Log in or Sign Up to review the conditions and access this model content.

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

  1. PRD Generation โ€” Full fidelity, hierarchical task decomposition preserved
  2. Code Review โ€” All quality retained from bf16
  3. 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 .gguf file in C:\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

Downloads last month
-
GGUF
Model size
4B params
Architecture
qwen3
Hardware compatibility
Log In to add your hardware

8-bit

Inference Providers NEW
This model isn't deployed by any Inference Provider. ๐Ÿ™‹ Ask for provider support

Model tree for sinonchum/Qwen3-4B-Feiyue-v1-Q8_0

Quantized
(296)
this model