Update README.md

README.md

@@ -1,3 +1,91 @@
 ---
 license: apache-2.0
+base_model: google/gemma-4-12B-it
+library_name: peft
+pipeline_tag: text-generation
+tags:
+- lora
+- transformers
+- unsloth
+- gemma
+- gemma-4
+- tool-calling
+- function-calling
+- agent
+- coding
+- code-generation
 ---
+
+# Coding Monkey Gemma
+
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Deploy on Lorivo](https://img.shields.io/badge/Deploy%20on-Lorivo-000000?style=flat&logoColor=white&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxyZWN0IHg9IjEiIHk9IjE3IiB3aWR0aD0iMyIgaGVpZ2h0PSI2IiByeD0iMSIvPjxyZWN0IHg9IjciIHk9IjEyIiB3aWR0aD0iMyIgaGVpZ2h0PSIxMSIgcng9IjEiLz48cmVjdCB4PSIxMyIgeT0iNyIgd2lkdGg9IjMiIGhlaWdodD0iMTYiIHJ4PSIxIi8+PHJlY3QgeD0iMTkiIHk9IjIiIHdpZHRoPSIzIiBoZWlnaHQ9IjIxIiByeD0iMSIvPjwvc3ZnPg==)](https://lorivo.dev/)
+
+Many people praise Gemma 4 26B for it's coding capabilities and for good reason. However the model is simply too large to run comfortable without heavy quantization compromises on a consumer GPU and so I turned to the 12B varient only to find that it fails at even basic coding tasks because it doesn't understand how to properly utilize the correct tools from the agent harness. So this model is a fine tune of Gemma 4 12B with reliable tool calling. The results speak for themselves showing a 71% reliability on exact tool calling on a 102-prompt held-out set which means correct ChatML syntax and parameter placement. This is a huge improvement over the base model which only had a 26.5% reliability on exact tool calling. I also saw a 16% increase in the number of tool calls actually emitted by the model which means that the model is more likely to actually use the tools it has access to which is huge for coding tasks. This model is great for anyone who wants to do local coding but is tight on VRAM.
+
+| Metric | Base `-it` | Fine-tuned | Δ |
+| --- | ---: | ---: | ---: |
+| Format Validity | 0.824 | 0.980 | **+0.157** |
+| Exact Accuracy | 0.265 | 0.706 | **+0.441** |
+| Emitted Calls Fraction | 0.824 | 0.980 | **+0.157** |
+
+_n = 102 held-out prompts, none ever seen during training. This set is harder than
+an earlier 67-item eval because it now includes multi-argument database,
+knowledge-graph and shell tasks that are matched exactly._
+
+## Training Details
+For the training of this model I used the QLoRA method with a 16GB 5070 Ti. It 3 hours and 48 minutes to complete (480 steps) however previous protyping totaled 30 hours aggregate. The training loss went from 1.695 to 0.120 and the held-out eval loss was 0.206. I could've trained for much longer but I ran into overfitting issues on previous attempts so I decided that training on a small concentrated dataset was the best option. The training dataset consisted of 5,211 high-quality agentic/tool-calling examples, every one formatted with Gemma 4's own chat template. The glaiveai was the bulk of the data but I also included AgentInstruct examples because they had real world bash and terminal actions. I converted those raw ReAct trajectories (bash, SQL, web, and knowledge-graph actions) into real structured Gemma tool calls instead of plain text. I split it 98/2 into 5,107 train / 104 held-out val, and the eval set was built only from the val split so none of the 102 scored prompts were ever seen during training preventing contamination.
+
+The breakdown by source:
+
+| Source | Examples |
+| --- | ---: |
+| `glaiveai/glaive-function-calling-v2` | 3,347 |
+| `zai-org/AgentInstruct` — alfworld | 336 |
+| `zai-org/AgentInstruct` — webshop | 351 |
+| `zai-org/AgentInstruct` — os | 195 |
+| `zai-org/AgentInstruct` — mind2web | 120 |
+| `zai-org/AgentInstruct` — db | 538 |
+| `zai-org/AgentInstruct` — kg | 324 |
+| **Total** | **5,211** |
+
+That's \~5,161 actual tool-calling examples (\~99% of the set) trained over 3 epochs with QLoRA `r=16/alpha=32`, LR 2e-4 cosine, and an effective batch size of 32.
+
+## Quantization
+This model has fp16, Q8_0, Q6_K, Q5_K_M, and Q4_K_M quantization available in the gguf format. You can find them in this [repository](https://huggingface.co/TheOneWhoWill/Coding-Monkey-Gemma-GGUF)
+
+## Usage
+### llama.cpp
+To use this model with llama.cpp you can use the ggufs like so
+```bash
+llama-server \
+	-m gemma-coder-Q4_K_M.gguf
+	-c 32768
+```
+
+### Ollama
+Ollama requires you to create a model file with each gguf so you could have something like this
+```
+FROM ./gemma-coder-Q4_K_M.gguf
+PARAMETER num_ctx 32768
+```
+then you can run it like so with the Modelfile in the same directory as the gguf
+```bash
+ollama create coding-monkey -f Modelfile
+```
+
+---
+
+## Serving & Deploying Fine-Tuned Adapters?
+
+Tired of merging LoRA weights, converting formats, and running quantization scripts just to get an OpenAI-compatible endpoint?
+
+Check out **[Lorivo](https://lorivo.dev/)**, a platform built to deploy and serve fine-tuned LoRA adapters instantly with production vLLM backends and standard OpenAI endpoints:
+
+- **Zero-Merge Serving:** Mount adapters dynamically on top of open-weight base models (Gemma, Qwen, Llama).
+- **Instant OpenAI Compatibility:** Plug directly into Cursor, Cline, Aider, or your custom agent harnesses.
+- **CLI & Web Control:** Deploy from your terminal via `lorivo deploy` or manage endpoints from the dashboard.
+
+👉 **[Deploy your fine-tuned adapters on Lorivo →](https://lorivo.dev/)**
+
+---