Instructions to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf 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 tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf 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 tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16 # Run inference directly in the terminal: llama cli -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16 # Run inference directly in the terminal: llama cli -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
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 tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16 # Run inference directly in the terminal: ./llama-cli -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
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 tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16 # Run inference directly in the terminal: ./build/bin/llama-cli -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
Use Docker
docker model run hf.co/tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
- LM Studio
- Jan
- vLLM
How to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
- Ollama
How to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf with Ollama:
ollama run hf.co/tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
- Unsloth Desktop
- Pi
How to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
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": "tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf with Docker Model Runner:
docker model run hf.co/tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
- Lemonade
How to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
Run and chat with the model
lemonade run user.omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf-F16
List all available models
lemonade list
- Hermes Agent
How to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
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 tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16
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 "tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-gguf:F16" \ --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"
OmniCoder-9B CoreGen HDLFix v2 GGUF
This repository contains the GGUF export set for the merged BF16 release of omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1.
It is the deployment-oriented companion to the Transformers-format merged checkpoint. The artifacts here were generated from the local merged BF16 model and are intended for LM Studio and llama.cpp style runtimes.
Included Files
All main model GGUF files in this repo depend on the included mmproj file for multimodal use.
| File | Approx. size | Notes |
|---|---|---|
mmproj-omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1_merged_bf16.f16.gguf |
0.855 GB |
multimodal projector required for image-aware use |
omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1_merged_bf16.bf16.gguf |
16.690 GB |
highest-fidelity GGUF export |
omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1_merged_bf16.Q8_0.gguf |
8.873 GB |
highest standard integer quant in this release |
omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1_merged_bf16.Q6_K.gguf |
6.854 GB |
good quality / size tradeoff |
omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1_merged_bf16.Q5_K_M.gguf |
6.024 GB |
smaller deployment option |
omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1_merged_bf16.MXFP4.gguf |
4.947 GB |
experimental dense MXFP4 export |
The repo also includes gguf_quantize_summary.json, which records the exact local conversion and quantization paths used for this artifact set.
Quantization Notes
Q8_0,Q6_K, andQ5_K_Mwere exported through the standard Windows GGUF pipeline.- The dense
MXFP4GGUF is experimental and was produced using a patched localllama.cppbuild rather than the stock release binary. - For this model family,
llama-quantizeemitted repeatedposition_embdandtoken_typesformatting warnings during quantization, but the process completed successfully and the resulting denseMXFP4artifact was produced. - The dense
MXFP4file has been validated as loadable in LM Studio on this machine.
Recommended Artifact Choice
- Use
Q6_Kas the default starting point if you want a balanced quality / size local deployment. - Use
Q8_0if you want the strongest standard quantized option and can afford the memory. - Use
Q5_K_Mif you need a smaller local footprint. - Use
MXFP4only if you specifically want to test the experimental dense MXFP4 path and your runtime supports it. - Use
BF16if you want the least quantization loss and have enough memory for the full file.
Runtime Notes
This is a multimodal OmniCoder-family export. For image-aware usage, pair any main model file with the included mmproj file.
In LM Studio, load the model GGUF together with the matching projector when multimodal features are needed.
In llama.cpp style runtimes, the exact multimodal command depends on the frontend you use, but the practical rule is the same: the main GGUF and the mmproj GGUF belong together.
Relationship to the Training Run
These GGUF files come from the merged BF16 release of a local fine-tune based on armand0e/OmniCoder-9B-Claude-Opus-High-Reasoning-Distill.
The underlying run focused on correcting earlier weaknesses in HDL behavior by:
- training across a full effective epoch instead of a short pilot run
- stripping visible reasoning markup from supervision
- removing leaked HDL target text from user prompts
- increasing HDL and bus/peripheral coverage in the training mix
The prepared dataset used for the run contained 3120 train examples and 428 eval examples, with explicit emphasis on HDL, code review, embedded programming, tool use, and math-heavy coding prompts.
Limitations
- This GGUF release inherits the limitations of the underlying merged model.
- It is intended for practical local inference, not as a guarantee of correctness for RTL signoff, firmware safety, or hardware interface behavior.
- The dense
MXFP4artifact is experimental and depends on a patched localllama.cpppath rather than a stock upstream release. - A broad external benchmark suite for this run is still missing; the main validated numeric signal remains the internal held-out eval loss of the original training run.
Companion Release
If you want the original Transformers-format merged checkpoint for further conversion or continued experimentation, use the separate merged BF16 repo:
tianrui6641/omnicoder_local9b_blackwell_coregen_hdlfix_v2_hf_r64_epoch1-merged-bf16
This GGUF repo is the deployment-oriented companion to that release.
- Downloads last month
- 81
4-bit
5-bit
6-bit
8-bit
16-bit