Instructions to use KikoCis/Agents-A1-IQ2_M-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 KikoCis/Agents-A1-IQ2_M-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 KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M # Run inference directly in the terminal: llama cli -hf KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M # Run inference directly in the terminal: llama cli -hf KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_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 KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M # Run inference directly in the terminal: ./llama-cli -hf KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_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 KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
Use Docker
docker model run hf.co/KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
- LM Studio
- Jan
- Ollama
How to use KikoCis/Agents-A1-IQ2_M-GGUF with Ollama:
ollama run hf.co/KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
- Unsloth Studio
How to use KikoCis/Agents-A1-IQ2_M-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 KikoCis/Agents-A1-IQ2_M-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 KikoCis/Agents-A1-IQ2_M-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for KikoCis/Agents-A1-IQ2_M-GGUF to start chatting
- Pi
How to use KikoCis/Agents-A1-IQ2_M-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
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": "KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use KikoCis/Agents-A1-IQ2_M-GGUF with Docker Model Runner:
docker model run hf.co/KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
- Lemonade
How to use KikoCis/Agents-A1-IQ2_M-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
Run and chat with the model
lemonade run user.Agents-A1-IQ2_M-GGUF-IQ2_M
List all available models
lemonade list
- Hermes Agent
How to use KikoCis/Agents-A1-IQ2_M-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 KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
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 KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use KikoCis/Agents-A1-IQ2_M-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M
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 "KikoCis/Agents-A1-IQ2_M-GGUF:IQ2_M" \ --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"
Agents-A1 โ IQ2_M GGUF
InternScience's Agents-A1 (a
35B-A3B hybrid-attention MoE agent model) quantized to a single **IQ2_M GGUF (11.7 GB)** that runs on a 16 GB machine. It solves real SWE-bench Verified tasks in an agentic Claude-Code-style loop. This is InternScience's model โ ours is the quant + imatrix + eval + ready-to-run Modelfiles. (No other GGUF existed when this was published, so this is the first-mover GGUF; if unsloth/others ship one, ours adds an imatrix, a documented agentic eval, and configurable-context Modelfiles.)
๐ฆ Which quant should I pick?
This repo ships the IQ2_M โ the sweet spot for a ~35B MoE: smallest that still runs real agentic loops sharply, made with an importance matrix (imatrix).
| file | bits | size | pick this ifโฆ |
|---|---|---|---|
Agents-A1-IQ2_M.gguf |
~2.7 | ~11.7 GB | the one in this repo โ fits 16 GB RAM/VRAM, still does agentic coding |
๐งฎ Will it fit? (RAM/VRAM cheat-sheet)
Total memory โ weights (~11.7 GB) + KV-cache (grows with context).
| you have | comfortable context |
|---|---|
| 16 GB | ~8โ32K |
| 24 GB | ~64โ128K |
| 32 GB+ | up to native 256K |
If you OOM, lower num_ctx (see CONTEXT.md).
๐ง Context size (native 262,144 / 256K)
Configurable โ Modelfiles at 8K / 32K / 128K / native are included; full guide in CONTEXT.md. 32K is the recommended default for agentic/coding work.
๐ How to run it
# Ollama (build a 32K-context model from the included Modelfile)
ollama create agents-a1-32k -f Modelfile.32k
ollama run agents-a1-32k
# llama.cpp (use a recent build โ this is a qwen3_5_moe hybrid-attention MoE)
llama-server -m Agents-A1-IQ2_M.gguf -c 32768 --jinja --temp 1.0 --top-p 0.95
Recommended sampling: temperature 1.0, top_p 0.95. This is a reasoning model โ it emits a thinking channel before its answer; keep temperature high (โ1.0). Low temperature (โค0.2) tends to cause repetition loops.
Agentic use: native tool-calling works out of the box with the model's bundled chat template โ pass your tools via the standard OpenAI/tools parameter (or Anthropic-style via a bridge) and it returns proper tool_calls. No text-injection workaround needed.
โ ๏ธ Needs a recent llama.cpp. Agents-A1 is a
qwen3_5_moehybrid (gated-delta-net linear-attention layers + MoE, every-4th-layer full attention). It requires a llama.cpp build new enough to include theqwen35moegraph. Older builds will fail to load it.
โ ๏ธ Good to know
- Strengths: agentic coding / tool use โ runs clean multi-turn Claude-Code-style loops, makes decisive single tool calls per turn, doesn't degenerate. Long native context (256K). Efficient: ~3B active params (MoE) so it's fast for its size.
- Limits: this is a 2-bit quant of a small-active-params MoE โ it will not match a full-precision 70B. On the hardest, multi-file SWE tasks it often explores well but doesn't always land the exact fix. Use โฅ Q4 if you have the RAM and need max fidelity (not shipped here; quantize from the source if needed).
- Quirk: emits an internal reasoning/thinking channel; if your client shows it, you can strip everything before the final answer.
๐ Evaluation methodology (MANDATORY โ never lose how it was measured)
- Score: 1/5 on a fail-fast swe-mix pre-screen subset (5 SWE-bench Verified django instances). Resolved: django__django-11099 (1/1 tests). The gate to publish is resolve โฅ 1 โ this build passed. All 5 ran clean agentic loops (37โ39 tool calls each, 0 empty/degenerate turns, no crash or loop).
- Exact instances (pre-screen):
django__django-11133(โ),django__django-11099(โ),django__django-13590(โ),django__django-13933(โ),django__django-14608(โ). The full 30-instance discriminating probe spec is inswe_mix.jsonโ 6 continuity anchors + 24 discriminating (10 repos); the pre-screen runs the first 5. - Harness: Claude Code + agent-bridge.js (AnthropicโOpenAI translation, context eviction) โ llama.cpp
llama-server, in terminal-bench / Docker, nativetoolscalling, 80-message cap per task. - Sampling: temperature 1.0, top_p 0.95. Tool format: native (
toolsparam; not bypassed โ the model's chat template emits propertool_calls). - Quant: IQ2_M, imatrix computed on a code+general corpus (273ร512-tok chunks, final PPL โ 1.82 on the calib set), 11.66 GB, requantized from a near-lossless Q8_0 intermediate.
- Date: 2026-06-29. Caveat: small/hard local probe, relative ranking โ NOT 1:1 with the official SWE-bench leaderboard.
๐๏ธ Changelog
- 2026-06-29 v1: initial IQ2_M release. SWE-mix pre-screen: 1/5 (resolved
django__django-11099, 1/1 tests) โ gate passed. Clean agentic loops on all 5 (native tool calls, 0 degenerate turns). Probe spec inswe_mix.json.
๐ Credit & license
Model, weights, and training: ยฉ InternScience โ InternScience/Agents-A1. Quant (IQ2_M) + importance matrix + agentic eval + context Modelfiles: KikoCis. apache-2.0 (same as upstream). No weights were modified beyond quantization โ this is a faithful re-quant, not a fine-tune.
- Downloads last month
- 97
2-bit
Model tree for KikoCis/Agents-A1-IQ2_M-GGUF
Base model
InternScience/Agents-A1