Instructions to use rahul05ranjan/hydra-nano-git with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use rahul05ranjan/hydra-nano-git with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("rahul05ranjan/hydra-nano-git") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Pi
How to use rahul05ranjan/hydra-nano-git with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "rahul05ranjan/hydra-nano-git"
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "rahul05ranjan/hydra-nano-git" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use rahul05ranjan/hydra-nano-git with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "rahul05ranjan/hydra-nano-git"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "rahul05ranjan/hydra-nano-git" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "rahul05ranjan/hydra-nano-git", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use rahul05ranjan/hydra-nano-git with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "rahul05ranjan/hydra-nano-git"
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 rahul05ranjan/hydra-nano-git
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use rahul05ranjan/hydra-nano-git with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "rahul05ranjan/hydra-nano-git"
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 "rahul05ranjan/hydra-nano-git" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Hydra Nano Git (hydra-nano-git)
Hydra Nano Git is an enterprise-grade, specialized local coprocessor trained to handle read-only repository inspection, history auditing, branch analysis, and diff navigation for autonomous frontier coding agents (such as Claude Code, Antigravity, and Codex).
🏛️ Executive Summary & Value Proposition
Frontier coding agents waste 70% to 90% of their expensive context window and API rate limits dumping voluminous raw CLI outputs (git log, git diff, git status).
Hydra Nano solves this by acting as a deterministic local coprocessor:
- Zero Shell Command Risk: The model never generates raw shell commands. It selects strictly bounded read-only probes from a hardened menu (
status,log,diff,show,blame,branches,stash,worktrees). - Grounded Runtime Verification: Strict parameter validation ensures branch names, commit hashes, authors, and file paths exist before execution.
- Extreme Token Savings: Preserves high-value frontier context while maintaining 100% factual fidelity.
- Sub-second Local Inference: ~140ms per task on Apple Silicon M-series GPUs and modern local accelerators.
📊 Proven Benchmark & Evaluation
Evaluated across the sealed 1,000-task git1 benchmark and development suites:
| Metric | Score | Industry Standard |
|---|---|---|
| Plan Accuracy | 83.0% | Plan selection for diverse git queries |
| Sealed Task Solved Rate | 77.0% | Usage-weighted solved accuracy on sealed benchmark |
| High-Frequency Query Solved Rate | 90% - 100% | branch_current (100%), last_commit (100%), modified_files (90%), staged_files (90%) |
| Inference Latency | ~140ms | Local Apple Silicon M-series GPU |
| Token Reduction | 73.3% - 88.4% | Average context reduction compared to raw git dumps |
🚀 Quickstart & Usage
Via Ollama
ollama run rahul05ranjan/hydra-nano-git
Via Hydra CLI
hydra ask --head git "which branch am I on and what files are modified?"
Via Python (transformers)
from transformers import AutoModelForCausalLM, AutoTokenizer
model_id = "rahul05ranjan/hydra-nano-git"
tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype="auto", device_map="auto")
prompt = "Which commits did alice touch last week?"
inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
outputs = model.generate(**inputs, max_new_tokens=256, temperature=0.0)
print(tokenizer.decode(outputs[0], skip_special_tokens=True))
🔒 Security & Safe Execution Policy
- Read-Only Guarantee: Does not support state-mutating operations (
git commit,git push,git rebase,git reset). - No Prompt Injection Shell Escalation: Command generation is entirely programmatic; model outputs strictly conform to a JSON probe schema.
📜 Specifications
- Base Architecture: Qwen3.5-0.8B Dense Hybrid Attention
- Parameters: 752.39M
- Max Context Window: 262,144 tokens (8,192 default in Ollama)
- Precision: BF16 / INT8 Quantized
- License: Apache 2.0
- Downloads last month
- 28
Quantized