Instructions to use MicroFlare/NanoFlare-v1 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 MicroFlare/NanoFlare-v1 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 MicroFlare/NanoFlare-v1:Q2_0 # Run inference directly in the terminal: llama cli -hf MicroFlare/NanoFlare-v1:Q2_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf MicroFlare/NanoFlare-v1:Q2_0 # Run inference directly in the terminal: llama cli -hf MicroFlare/NanoFlare-v1:Q2_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 MicroFlare/NanoFlare-v1:Q2_0 # Run inference directly in the terminal: ./llama-cli -hf MicroFlare/NanoFlare-v1:Q2_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 MicroFlare/NanoFlare-v1:Q2_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf MicroFlare/NanoFlare-v1:Q2_0
Use Docker
docker model run hf.co/MicroFlare/NanoFlare-v1:Q2_0
- LM Studio
- Jan
- Ollama
How to use MicroFlare/NanoFlare-v1 with Ollama:
ollama run hf.co/MicroFlare/NanoFlare-v1:Q2_0
- Unsloth Desktop
- Pi
How to use MicroFlare/NanoFlare-v1 with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf MicroFlare/NanoFlare-v1:Q2_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": "MicroFlare/NanoFlare-v1:Q2_0" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use MicroFlare/NanoFlare-v1 with Docker Model Runner:
docker model run hf.co/MicroFlare/NanoFlare-v1:Q2_0
- Lemonade
How to use MicroFlare/NanoFlare-v1 with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull MicroFlare/NanoFlare-v1:Q2_0
Run and chat with the model
lemonade run user.NanoFlare-v1-Q2_0
List all available models
lemonade list
- Hermes Agent
How to use MicroFlare/NanoFlare-v1 with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf MicroFlare/NanoFlare-v1:Q2_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 MicroFlare/NanoFlare-v1:Q2_0
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use MicroFlare/NanoFlare-v1 with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf MicroFlare/NanoFlare-v1:Q2_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 "MicroFlare/NanoFlare-v1:Q2_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"
NanoFlare is my newest model, based on the recently released Qwen 3.8 27B. It is designed to run completely on GPU if you have 8GB of VRAM, otherwise it can be run on CPU if you have at least 10GB or more of system memory (this will be slow). I have applied a non-uniform quantization across the weights, allocating more precision to the more sensitive parts of the model to preserve as much quality as possible.
v1.c is the latest version (recommended)
Revision C brings more improvements to the quality of output, and coherence in the model's reasoning process. It's been squeezed down to a reduced size so that a small kv cache can be fit onto the GPU as well.
If you are running NanoFlare on an 8GB GPU, you can have up to around an 8k context on GPU (tested with k:q5_0, v:iq4_nl), but if you want it higher you will have to offload the kv cache to CPU.
The MTP draft predictor is stripped out of regular NanoFlare to save space, but there is also a build that includes it, look for "--with-mtp" in the file name. Note, I can not get this version to fit fully onto my own 8GB card, so to use the MTP included version you may need a 10GB GPU or bigger.
Relative perplexity scores (all tested with wikitext2, lower is better):
| Model | Size | 2k ctx PPL | 8k ctx PPL |
|---|---|---|---|
| v1 revision c | 7130.2 MB | 8.1826 ยฑ0.05284 | 7.8064 ยฑ0.05058 |
| v1 revision b | 7469.3 MB | 8.2480 ยฑ0.05573 | 7.9631 ยฑ0.05479 |
| unsloth/IQ2_XXS (UD 3.0) | 6929.5 MB | 7.5441 ยฑ0.04906 | 8.0013 ยฑ0.05689 |
| v1 revision a | 7165.9 MB | 8.6832 ยฑ0.05605 | 8.1774 ยฑ0.05276 |
| release candidate 1 | 7442.6 MB | 8.7946 ยฑ0.05764 | 8.2998 ยฑ0.05454 |
| beta 1 | 7532.8 MB | 8.8221 ยฑ0.05797 | 8.3352 ยฑ0.05506 |
The model seems to run best at temperature: 0.95 + top-k: 20.
Note this model has been hyper-compressed, so it's not perfect. It may flake out on you from time to time, but it is mostly fairly stable. Taking quantization to the extreme levels I'm using comes at a cost. The LLM will sometimes not complete its thought process. If you find yourself in this situation, try the prompt again. It often works correctly on the second try when this happens. It seems to be pretty good at most general tasks, and is good at coding. It has forgotten some facts and figures from its training data through the heavy quantization, so I'd recommend giving it web search access or double checking anything its telling you from recall.
From subjective, manual testing v1.c seems to be the most stable and usable version so far.
MMLU Pro (limited) Results*
*note only a partial set was ran, the first 20 questions in each of the 14 categories
Tests were ran at a 5 shot with an 8k context, using NanoFlare v1.c. Top-k: 40, Temperature: 0.80 (llama.cpp defaults)
| Tasks | Version | Filter | n-shot | Metric | Value | Stderr |
|---|---|---|---|---|---|---|
| biology | 3.1 | custom-extract | 5 | exact_match | 0.9 | ยฑ0.0688 |
| business | 3.1 | custom-extract | 5 | exact_match | 0.65 | ยฑ0.1094 |
| chemistry | 3.1 | custom-extract | 5 | exact_match | 0.75 | ยฑ0.0993 |
| computer_science | 3.1 | custom-extract | 5 | exact_match | 0.7 | ยฑ0.1051 |
| economics | 3.1 | custom-extract | 5 | exact_match | 0.6 | ยฑ0.1124 |
| engineering | 3.1 | custom-extract | 5 | exact_match | 0.45 | ยฑ0.1141 |
| health | 3.1 | custom-extract | 5 | exact_match | 0.5 | ยฑ0.1147 |
| history | 3.1 | custom-extract | 5 | exact_match | 0.5 | ยฑ0.1147 |
| law | 3.1 | custom-extract | 5 | exact_match | 0.45 | ยฑ0.1141 |
| math | 3.1 | custom-extract | 5 | exact_match | 0.65 | ยฑ0.1094 |
| other | 3.1 | custom-extract | 5 | exact_match | 0.6 | ยฑ0.1124 |
| philosophy | 3.1 | custom-extract | 5 | exact_match | 0.55 | ยฑ0.1141 |
| physics | 3.1 | custom-extract | 5 | exact_match | 0.55 | ยฑ0.1141 |
| psychology | 3.1 | custom-extract | 5 | exact_match | 0.65 | ยฑ0.1094 |
| Total | MMLU Pro | average | 0.61 |
So NanoFlare should give you fairly decent quality, but microFlare scored a 0.73 and will give you more stable output.
For more details, see my announcment blog post.
- Downloads last month
- 2,701
2-bit
Model tree for MicroFlare/NanoFlare-v1
Base model
Qwen/Qwen3.8-27B