Instructions to use WithinUsAI/Agent.Nano.Coder-2B-gguf with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use WithinUsAI/Agent.Nano.Coder-2B-gguf with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="WithinUsAI/Agent.Nano.Coder-2B-gguf", filename="Agent.Nano.Coder-Q4_K_M.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use WithinUsAI/Agent.Nano.Coder-2B-gguf with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M # Run inference directly in the terminal: llama-cli -hf WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M # Run inference directly in the terminal: llama-cli -hf WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
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 WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
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 WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
Use Docker
docker model run hf.co/WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use WithinUsAI/Agent.Nano.Coder-2B-gguf with Ollama:
ollama run hf.co/WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
- Unsloth Studio
How to use WithinUsAI/Agent.Nano.Coder-2B-gguf with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for WithinUsAI/Agent.Nano.Coder-2B-gguf to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for WithinUsAI/Agent.Nano.Coder-2B-gguf to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for WithinUsAI/Agent.Nano.Coder-2B-gguf to start chatting
- Docker Model Runner
How to use WithinUsAI/Agent.Nano.Coder-2B-gguf with Docker Model Runner:
docker model run hf.co/WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
- Lemonade
How to use WithinUsAI/Agent.Nano.Coder-2B-gguf with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull WithinUsAI/Agent.Nano.Coder-2B-gguf:Q4_K_M
Run and chat with the model
lemonade run user.Agent.Nano.Coder-2B-gguf-Q4_K_M
List all available models
lemonade list
Update README.md
Browse files
README.md
CHANGED
|
@@ -32,4 +32,190 @@ datasets:
|
|
| 32 |
- manu/project_gutenberg
|
| 33 |
- storytracer/LoC-PD-Books
|
| 34 |
- allenai/dolma
|
| 35 |
-
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 32 |
- manu/project_gutenberg
|
| 33 |
- storytracer/LoC-PD-Books
|
| 34 |
- allenai/dolma
|
| 35 |
+
---
|
| 36 |
+
Agent.Nano.Coder-2B (GGUF)
|
| 37 |
+
|
| 38 |
+
📌 Model Overview
|
| 39 |
+
|
| 40 |
+
Model Name: WithinUsAI/Agent.Nano.Coder-2B-gguf
|
| 41 |
+
Organization: Within Us AI
|
| 42 |
+
Model Type: Lightweight Agentic Code LLM
|
| 43 |
+
Parameter Size: 2B
|
| 44 |
+
Format: GGUF (quantized for local inference)
|
| 45 |
+
Primary Focus: Ultra-efficient coding + agent workflows
|
| 46 |
+
|
| 47 |
+
This model is a compact, high-efficiency coding agent, designed to deliver useful software engineering reasoning in extremely small compute environments.
|
| 48 |
+
|
| 49 |
+
It belongs to the Within Us AI family of agentic coders, emphasizing action-oriented outputs over passive text generation. 
|
| 50 |
+
|
| 51 |
+
⸻
|
| 52 |
+
|
| 53 |
+
🧬 Architecture & Lineage
|
| 54 |
+
|
| 55 |
+
* Model Class: Small-scale transformer (2B parameter range)
|
| 56 |
+
* Design Goal: Maximize reasoning-per-parameter
|
| 57 |
+
* Format Conversion: GGUF quantization for local runtime compatibility
|
| 58 |
+
|
| 59 |
+
Ecosystem Context
|
| 60 |
+
|
| 61 |
+
Part of a broader WithinUsAI lineup including:
|
| 62 |
+
|
| 63 |
+
* 4B agentic coders
|
| 64 |
+
* reasoning-distilled Gemma variants
|
| 65 |
+
* nano-scale experimental models
|
| 66 |
+
|
| 67 |
+
The Nano series focuses on:
|
| 68 |
+
|
| 69 |
+
“Minimum size, maximum usefulness.”
|
| 70 |
+
|
| 71 |
+
⸻
|
| 72 |
+
|
| 73 |
+
🧠 Core Design Philosophy
|
| 74 |
+
|
| 75 |
+
This model is built around a sharp constraint:
|
| 76 |
+
|
| 77 |
+
If a model only has 2B parameters… every neuron has to earn its place.
|
| 78 |
+
|
| 79 |
+
Key ideas:
|
| 80 |
+
|
| 81 |
+
* Prioritize coding over general chat
|
| 82 |
+
* Bias toward structured outputs
|
| 83 |
+
* Encourage step-based reasoning
|
| 84 |
+
* Optimize for tool-augmented environments
|
| 85 |
+
|
| 86 |
+
⸻
|
| 87 |
+
|
| 88 |
+
⚙️ Key Capabilities
|
| 89 |
+
|
| 90 |
+
💻 Coding
|
| 91 |
+
|
| 92 |
+
* Python, JavaScript, C++, and more
|
| 93 |
+
* Function generation and refactoring
|
| 94 |
+
* Lightweight debugging assistance
|
| 95 |
+
|
| 96 |
+
🤖 Agentic Behavior
|
| 97 |
+
|
| 98 |
+
* Task decomposition
|
| 99 |
+
* Instruction-following for multi-step tasks
|
| 100 |
+
* Compatible with external tool pipelines
|
| 101 |
+
|
| 102 |
+
🧠 Reasoning (Compact)
|
| 103 |
+
|
| 104 |
+
* Basic chain-of-thought patterns
|
| 105 |
+
* Logical step breakdowns
|
| 106 |
+
* Efficient problem-solving within tight parameter limits
|
| 107 |
+
|
| 108 |
+
⸻
|
| 109 |
+
|
| 110 |
+
📦 GGUF Format & Deployment
|
| 111 |
+
|
| 112 |
+
Designed for fast, local inference with minimal hardware.
|
| 113 |
+
|
| 114 |
+
Compatible Runtimes:
|
| 115 |
+
|
| 116 |
+
* llama.cpp
|
| 117 |
+
* LM Studio
|
| 118 |
+
* Ollama (GGUF-compatible builds)
|
| 119 |
+
|
| 120 |
+
Typical Quantization Sizes (2B class):
|
| 121 |
+
|
| 122 |
+
* Q4_K_M (~1.1–1.4GB)
|
| 123 |
+
* Q5_K_M (~1.3–1.6GB)
|
| 124 |
+
|
| 125 |
+
⸻
|
| 126 |
+
|
| 127 |
+
🚀 Intended Use
|
| 128 |
+
|
| 129 |
+
✅ Ideal Use Cases
|
| 130 |
+
|
| 131 |
+
* Low-resource coding assistants
|
| 132 |
+
* Embedded / edge AI systems
|
| 133 |
+
* Fast iteration environments
|
| 134 |
+
* Local copilots on consumer hardware
|
| 135 |
+
* Multi-agent systems with many small models
|
| 136 |
+
|
| 137 |
+
⚠️ Limitations
|
| 138 |
+
|
| 139 |
+
* Smaller parameter count limits deep reasoning depth
|
| 140 |
+
* Not suited for highly complex multi-domain reasoning
|
| 141 |
+
* Performance depends heavily on prompt clarity
|
| 142 |
+
|
| 143 |
+
⸻
|
| 144 |
+
|
| 145 |
+
🛠️ Usage Example (llama.cpp)
|
| 146 |
+
|
| 147 |
+
./main -m Agent.Nano.Coder-2B.Q4_K_M.gguf \
|
| 148 |
+
-p "Write a Python function to validate email addresses using regex." \
|
| 149 |
+
-n 256
|
| 150 |
+
|
| 151 |
+
⸻
|
| 152 |
+
|
| 153 |
+
🧪 Training & Methodology
|
| 154 |
+
|
| 155 |
+
Within Us AI approach emphasizes:
|
| 156 |
+
|
| 157 |
+
* Agentic coding datasets
|
| 158 |
+
* Instruction-tuned workflows
|
| 159 |
+
* Reasoning traces (lightweight)
|
| 160 |
+
* Evaluation-driven refinement
|
| 161 |
+
|
| 162 |
+
Data Sources
|
| 163 |
+
|
| 164 |
+
* Proprietary datasets created by Within Us AI
|
| 165 |
+
* Third-party datasets may be used without ownership claims
|
| 166 |
+
* Focus on:
|
| 167 |
+
* Code tasks
|
| 168 |
+
* Debugging patterns
|
| 169 |
+
* Structured outputs
|
| 170 |
+
|
| 171 |
+
⸻
|
| 172 |
+
|
| 173 |
+
📊 Expected Performance Profile
|
| 174 |
+
|
| 175 |
+
Capability Strength
|
| 176 |
+
Coding (basic–intermediate) High
|
| 177 |
+
Speed / efficiency Very High
|
| 178 |
+
Reasoning depth Moderate
|
| 179 |
+
General knowledge Moderate
|
| 180 |
+
Tool-use readiness High
|
| 181 |
+
|
| 182 |
+
⸻
|
| 183 |
+
|
| 184 |
+
📜 License
|
| 185 |
+
|
| 186 |
+
License Type: Custom / Other (Within Us AI License Model)**
|
| 187 |
+
|
| 188 |
+
Terms:
|
| 189 |
+
|
| 190 |
+
* Base architectures originate from third-party LLM ecosystems
|
| 191 |
+
* Within Us AI developed:
|
| 192 |
+
* Fine-tuning methodology
|
| 193 |
+
* Merging processes
|
| 194 |
+
* Training pipelines
|
| 195 |
+
* Third-party datasets are used without ownership claims
|
| 196 |
+
* Full credit belongs to original creators
|
| 197 |
+
|
| 198 |
+
⸻
|
| 199 |
+
|
| 200 |
+
🙏 Acknowledgements
|
| 201 |
+
|
| 202 |
+
* Open-source LLM community
|
| 203 |
+
* GGUF / llama.cpp ecosystem
|
| 204 |
+
* Dataset contributors across Hugging Face
|
| 205 |
+
* Researchers advancing small-model efficiency
|
| 206 |
+
|
| 207 |
+
⸻
|
| 208 |
+
|
| 209 |
+
🔗 Links
|
| 210 |
+
|
| 211 |
+
* Model: https://huggingface.co/WithinUsAI/Agent.Nano.Coder-2B-gguf
|
| 212 |
+
* Organization: https://huggingface.co/WithinUsAI
|
| 213 |
+
|
| 214 |
+
⸻
|
| 215 |
+
|
| 216 |
+
🧩 Closing Note
|
| 217 |
+
|
| 218 |
+
This model is like a pocket-sized engineer 🧰⚡
|
| 219 |
+
|
| 220 |
+
Not built to dominate benchmarks…
|
| 221 |
+
but to quietly get things done fast, locally, and efficiently.
|