Text Generation
GGUF
Rust
English
ruvllm
agent-routing
claude-code
recursive-language-model
embeddings
llm-inference
sona
hnsw
simd
imatrix
conversational
Instructions to use ruv/ruvltra 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 ruv/ruvltra 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 ruv/ruvltra:Q4_K_M # Run inference directly in the terminal: llama cli -hf ruv/ruvltra:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf ruv/ruvltra:Q4_K_M # Run inference directly in the terminal: llama cli -hf ruv/ruvltra: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 ruv/ruvltra:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf ruv/ruvltra: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 ruv/ruvltra:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf ruv/ruvltra:Q4_K_M
Use Docker
docker model run hf.co/ruv/ruvltra:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use ruv/ruvltra with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ruv/ruvltra" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "ruv/ruvltra", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/ruv/ruvltra:Q4_K_M
- Ollama
How to use ruv/ruvltra with Ollama:
ollama run hf.co/ruv/ruvltra:Q4_K_M
- Unsloth Desktop
- Docker Model Runner
How to use ruv/ruvltra with Docker Model Runner:
docker model run hf.co/ruv/ruvltra:Q4_K_M
- Lemonade
How to use ruv/ruvltra with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull ruv/ruvltra:Q4_K_M
Run and chat with the model
lemonade run user.ruvltra-Q4_K_M
List all available models
lemonade list
- Atomic Chat
docs: remove redundant metrics and honest assessment sections
Browse files
README.md
CHANGED
|
@@ -33,7 +33,7 @@ pipeline_tag: text-generation
|
|
| 33 |
|
| 34 |
**Save Money & Time: Local Routing and Embeddings for Claude Code**
|
| 35 |
|
| 36 |
-
[Install](#-quick-start) β’ [Use Cases](#-what-ruvltra-is-for) β’ [Rust Crates](#-rust-crates) β’ [
|
| 37 |
|
| 38 |
```
|
| 39 |
Query β HNSW Index β GNN Layer β Enhanced Results
|
|
@@ -66,43 +66,7 @@ Those benchmarks test code generation from scratch. **RuvLTRA isn't meant to com
|
|
| 66 |
|
| 67 |
---
|
| 68 |
|
| 69 |
-
##
|
| 70 |
-
|
| 71 |
-
For routing and embeddings, you'd want to measure:
|
| 72 |
-
|
| 73 |
-
1. **Routing accuracy** - Does it pick the right agent for a task?
|
| 74 |
-
2. **Embedding quality** - Do similar tasks cluster together in HNSW?
|
| 75 |
-
3. **SONA learning rate** - Does it improve with feedback?
|
| 76 |
-
4. **Latency** - Can it make decisions in <10ms locally?
|
| 77 |
-
5. **Memory efficiency** - Can it run alongside Claude Code?
|
| 78 |
-
|
| 79 |
-
---
|
| 80 |
-
|
| 81 |
-
## π Honest Assessment
|
| 82 |
-
|
| 83 |
-
We don't know yet if RuvLTRA is better for your use case because:
|
| 84 |
-
|
| 85 |
-
- β No routing accuracy benchmarks
|
| 86 |
-
- β No embedding quality metrics (vs OpenAI, Cohere, etc.)
|
| 87 |
-
- β No A/B testing against alternatives (e.g., `nomic-embed-text`, `bge-small`)
|
| 88 |
-
|
| 89 |
-
**What would prove it:**
|
| 90 |
-
|
| 91 |
-
```bash
|
| 92 |
-
# Create a routing benchmark
|
| 93 |
-
ruvllm benchmark routing --tasks ./test-tasks.json --expected ./expected-agents.json
|
| 94 |
-
|
| 95 |
-
# Compare embedding quality
|
| 96 |
-
ruvllm benchmark embeddings --dataset ./code-similarity-pairs.json
|
| 97 |
-
```
|
| 98 |
-
|
| 99 |
-
**What we do know:** Latency <10ms β
| Memory ~500MB β
| Cost $0 β
|
| 100 |
-
|
| 101 |
-
---
|
| 102 |
-
|
| 103 |
-
## π° Cost Savings (Why This Exists)
|
| 104 |
-
|
| 105 |
-
Every API call costs money and time:
|
| 106 |
|
| 107 |
| Operation | Claude API | RuvLTRA Local | Savings |
|
| 108 |
|-----------|------------|---------------|---------|
|
|
@@ -110,7 +74,7 @@ Every API call costs money and time:
|
|
| 110 |
| Embedding generation | $0.0001 / call | $0 | **100%** |
|
| 111 |
| Latency | ~500ms | <10ms | **50x faster** |
|
| 112 |
|
| 113 |
-
**Monthly example:** 50K routing calls = $150 saved. 100K embeddings = $10 saved. **
|
| 114 |
|
| 115 |
---
|
| 116 |
|
|
|
|
| 33 |
|
| 34 |
**Save Money & Time: Local Routing and Embeddings for Claude Code**
|
| 35 |
|
| 36 |
+
[Install](#-quick-start) β’ [Use Cases](#-what-ruvltra-is-for) β’ [Rust Crates](#-rust-crates) β’ [Models](#-available-models)
|
| 37 |
|
| 38 |
```
|
| 39 |
Query β HNSW Index β GNN Layer β Enhanced Results
|
|
|
|
| 66 |
|
| 67 |
---
|
| 68 |
|
| 69 |
+
## π° Cost Savings
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 70 |
|
| 71 |
| Operation | Claude API | RuvLTRA Local | Savings |
|
| 72 |
|-----------|------------|---------------|---------|
|
|
|
|
| 74 |
| Embedding generation | $0.0001 / call | $0 | **100%** |
|
| 75 |
| Latency | ~500ms | <10ms | **50x faster** |
|
| 76 |
|
| 77 |
+
**Monthly example:** 50K routing calls = $150 saved. 100K embeddings = $10 saved. **~$250/month.**
|
| 78 |
|
| 79 |
---
|
| 80 |
|