Compare commits

..

1 Commits

Author SHA1 Message Date
Alexander Whitestone
f8f4678ee4 feat: benchmark local Ollama models against 50 tok/s threshold (#287)
Some checks failed
Forge CI / smoke-and-build (pull_request) Failing after 1m24s
Add scripts/benchmark_local_models.py — tests all local Ollama models
against the 50 tok/s UX threshold (configurable via --threshold).

Features:
- Auto-discovers all pulled Ollama models or test specific ones
- Configurable rounds, max tokens, threshold
- Per-round timing with prompt_eval/eval token breakdown
- Human-readable table report with PASS/FAIL/ERROR status
- JSON output mode (--json) for CI integration
- Exit code 1 if any model fails threshold

Usage:
  python3 scripts/benchmark_local_models.py                 # all models, 3 rounds
  python3 scripts/benchmark_local_models.py --models qwen2.5:7b  # single model
  python3 scripts/benchmark_local_models.py --json          # CI output
  python3 scripts/benchmark_local_models.py --threshold 30  # custom threshold

Tested: gemma3:1b scores 141.8 tok/s (PASS).

Closes #287
2026-04-13 17:46:53 -04:00
5 changed files with 290 additions and 283 deletions

View File

@@ -75,7 +75,7 @@ for base in ["/root/wizards/bezalel/hermes", "/root/wizards/bezalel/evennia"]:
write("06_git_repos", "\n".join(git_repos))
# 8. Python Dependencies
venv_pip = shell("$(find /root/wizards -maxdepth 4 -name pip -path '*/venv/bin/pip' 2>/dev/null | head -1) freeze 2>/dev/null | head -80")
venv_pip = shell("/root/wizards/bezalel/hermes/venv/bin/pip freeze 2>/dev/null | head -80")
write("07_dependencies", f"Hermes venv packages (top 80):\n{venv_pip}")
# 9. External APIs & Endpoints
@@ -115,8 +115,8 @@ mempalace = f"""MEMPALACE CONFIGURATION
- Identity: /root/.mempalace/identity.txt
- Config: /root/wizards/bezalel/mempalace.yaml
- Nightly re-mine: 03:00 UTC via /root/wizards/bezalel/mempalace_nightly.sh
- Miner binary: $(find /root/wizards -maxdepth 4 -name mempalace -path '*/venv/bin/mempalace' 2>/dev/null | head -1)
- Current status: {shell('$(find /root/wizards -maxdepth 4 -name mempalace -path "*/venv/bin/mempalace" 2>/dev/null | head -1) --palace /root/wizards/bezalel/.mempalace/palace status 2>/dev/null')}
- Miner binary: /root/wizards/bezalel/hermes/venv/bin/mempalace
- Current status: {shell('/root/wizards/bezalel/hermes/venv/bin/mempalace --palace /root/wizards/bezalel/.mempalace/palace status 2>/dev/null')}
"""
write("11_mempalace_topology", mempalace)

View File

@@ -0,0 +1,284 @@
#!/usr/bin/env python3
"""
Benchmark local Ollama models against the 50 tok/s UX threshold.
Usage:
python3 scripts/benchmark_local_models.py [--models MODEL1,MODEL2] [--prompt PROMPT] [--rounds N]
python3 scripts/benchmark_local_models.py --all # test all pulled models
python3 scripts/benchmark_local_models.py --json # JSON output for CI
"""
import argparse
import json
import os
import sys
import time
import urllib.request
import urllib.error
from dataclasses import dataclass, asdict
from typing import Optional
OLLAMA_BASE = os.environ.get("OLLAMA_BASE_URL", "http://localhost:11434")
THRESHOLD_TOK_S = 50.0
BENCHMARK_PROMPT = (
"Explain the difference between TCP and UDP protocols. "
"Cover reliability, ordering, speed, and use cases. "
"Be thorough but concise. Write at least 300 words."
)
@dataclass
class BenchmarkResult:
model: str
size_gb: float
prompt_tokens: int
eval_tokens: int
eval_duration_s: float
tokens_per_second: float
total_duration_s: float
rounds: int
avg_tok_s: float
meets_threshold: bool
error: Optional[str] = None
def get_models() -> list[dict]:
"""List all pulled Ollama models."""
url = f"{OLLAMA_BASE}/api/tags"
try:
req = urllib.request.Request(url)
with urllib.request.urlopen(req, timeout=10) as resp:
data = json.loads(resp.read())
return data.get("models", [])
except Exception as e:
print(f"Error connecting to Ollama at {OLLAMA_BASE}: {e}", file=sys.stderr)
sys.exit(1)
def benchmark_model(model: str, prompt: str, num_predict: int = 512) -> dict:
"""Run a single benchmark generation, return timing stats."""
url = f"{OLLAMA_BASE}/api/generate"
payload = json.dumps({
"model": model,
"prompt": prompt,
"stream": False,
"options": {
"num_predict": num_predict,
"temperature": 0.1, # low temp for consistent output
},
}).encode()
req = urllib.request.Request(url, data=payload, method="POST")
req.add_header("Content-Type", "application/json")
start = time.monotonic()
try:
with urllib.request.urlopen(req, timeout=300) as resp:
data = json.loads(resp.read())
except urllib.error.HTTPError as e:
body = e.read().decode() if e.fp else str(e)
raise RuntimeError(f"HTTP {e.code}: {body[:200]}")
except Exception as e:
raise RuntimeError(str(e))
elapsed = time.monotonic() - start
prompt_tokens = data.get("prompt_eval_count", 0)
eval_tokens = data.get("eval_count", 0)
eval_duration_ns = data.get("eval_duration", 0)
total_duration_ns = data.get("total_duration", 0)
eval_duration_s = eval_duration_ns / 1e9 if eval_duration_ns else elapsed
total_duration_s = total_duration_ns / 1e9 if total_duration_ns else elapsed
tok_s = eval_tokens / eval_duration_s if eval_duration_s > 0 else 0.0
return {
"prompt_tokens": prompt_tokens,
"eval_tokens": eval_tokens,
"eval_duration_s": round(eval_duration_s, 2),
"total_duration_s": round(total_duration_s, 2),
"tokens_per_second": round(tok_s, 1),
}
def run_benchmark(
model_name: str,
model_size: float,
prompt: str,
rounds: int,
num_predict: int,
threshold: float = 50.0,
) -> BenchmarkResult:
"""Run multiple rounds and compute average."""
results = []
errors = []
for i in range(rounds):
try:
r = benchmark_model(model_name, prompt, num_predict)
results.append(r)
print(f" Round {i+1}/{rounds}: {r['tokens_per_second']} tok/s "
f"({r['eval_tokens']} tokens in {r['eval_duration_s']}s)")
except Exception as e:
errors.append(str(e))
print(f" Round {i+1}/{rounds}: ERROR - {e}")
if not results:
return BenchmarkResult(
model=model_name,
size_gb=model_size,
prompt_tokens=0, eval_tokens=0,
eval_duration_s=0, tokens_per_second=0,
total_duration_s=0, rounds=rounds,
avg_tok_s=0, meets_threshold=False,
error="; ".join(errors),
)
avg_tok_s = sum(r["tokens_per_second"] for r in results) / len(results)
avg_tok_s = round(avg_tok_s, 1)
return BenchmarkResult(
model=model_name,
size_gb=model_size,
prompt_tokens=sum(r["prompt_tokens"] for r in results) // len(results),
eval_tokens=sum(r["eval_tokens"] for r in results) // len(results),
eval_duration_s=round(sum(r["eval_duration_s"] for r in results) / len(results), 2),
tokens_per_second=avg_tok_s,
total_duration_s=round(sum(r["total_duration_s"] for r in results) / len(results), 2),
rounds=len(results),
avg_tok_s=avg_tok_s,
meets_threshold=avg_tok_s >= threshold,
)
def format_report(results: list[BenchmarkResult], threshold: float = 50.0) -> str:
"""Format a human-readable benchmark report."""
lines = []
lines.append("")
lines.append("=" * 72)
lines.append(f" LOCAL MODEL BENCHMARK — {threshold:.0f} tok/s UX Threshold")
lines.append("=" * 72)
lines.append("")
# Summary table
header = f"{'Model':<25} {'Size':>6} {'tok/s':>8} {'Threshold':>10} {'Status':>8}"
lines.append(header)
lines.append("-" * 72)
passed = 0
failed = 0
errors = 0
for r in sorted(results, key=lambda x: x.avg_tok_s, reverse=True):
size_str = f"{r.size_gb:.1f}GB"
tok_s_str = f"{r.avg_tok_s:.1f}"
if r.error:
status = "ERROR"
errors += 1
elif r.meets_threshold:
status = "PASS"
passed += 1
else:
status = "FAIL"
failed += 1
marker = ">" if r.meets_threshold else "X" if r.error else "!"
thresh_str = f">= {threshold:.0f}"
lines.append(f" {marker} {r.model:<23} {size_str:>6} {tok_s_str:>8} {thresh_str:>10} {status:>8}")
lines.append("-" * 72)
lines.append(f" Passed: {passed} | Failed: {failed} | Errors: {errors} | Total: {len(results)}")
lines.append("")
# Detail section for failures
failures = [r for r in results if not r.meets_threshold and not r.error]
if failures:
lines.append(" FAILED MODELS (below threshold):")
for r in sorted(failures, key=lambda x: x.avg_tok_s):
gap = threshold - r.avg_tok_s
lines.append(f" - {r.model}: {r.avg_tok_s:.1f} tok/s "
f"({gap:.1f} tok/s short, {r.eval_tokens} avg tokens/round)")
lines.append("")
error_list = [r for r in results if r.error]
if error_list:
lines.append(" ERRORS:")
for r in error_list:
lines.append(f" - {r.model}: {r.error}")
lines.append("")
# Hardware info
import platform
lines.append(f" Host: {platform.node()} | {platform.system()} {platform.release()}")
lines.append(f" Ollama: {OLLAMA_BASE}")
lines.append("")
return "\n".join(lines)
def main():
parser = argparse.ArgumentParser(description="Benchmark local Ollama models vs 50 tok/s threshold")
parser.add_argument("--models", help="Comma-separated model names (default: all)")
parser.add_argument("--prompt", default=BENCHMARK_PROMPT, help="Benchmark prompt")
parser.add_argument("--rounds", type=int, default=3, help="Rounds per model (default: 3)")
parser.add_argument("--tokens", type=int, default=512, help="Max tokens to generate (default: 512)")
parser.add_argument("--json", action="store_true", help="JSON output for CI")
parser.add_argument("--all", action="store_true", help="Test all pulled models")
parser.add_argument("--threshold", type=float, default=THRESHOLD_TOK_S, help="tok/s threshold")
args = parser.parse_args()
threshold = args.threshold
# Get model list
available = get_models()
if not available:
print("No models found. Pull a model first: ollama pull <model>", file=sys.stderr)
sys.exit(1)
if args.models:
names = [m.strip() for m in args.models.split(",")]
models = [m for m in available if m["name"] in names]
missing = set(names) - set(m["name"] for m in models)
if missing:
print(f"Models not found: {', '.join(missing)}", file=sys.stderr)
print(f"Available: {', '.join(m['name'] for m in available)}", file=sys.stderr)
else:
models = available
print(f"Benchmarking {len(models)} model(s) against {threshold} tok/s threshold")
print(f"Ollama: {OLLAMA_BASE} | Rounds: {args.rounds} | Max tokens: {args.tokens}")
print()
results = []
for m in models:
name = m["name"]
size_gb = m.get("size", 0) / (1024**3)
print(f" {name} ({size_gb:.1f}GB):")
result = run_benchmark(name, size_gb, args.prompt, args.rounds, args.tokens, threshold)
results.append(result)
# Output
report = format_report(results, threshold)
if args.json:
output = {
"threshold_tok_s": threshold,
"ollama_base": OLLAMA_BASE,
"rounds": args.rounds,
"results": [asdict(r) for r in results],
"passed": sum(1 for r in results if r.meets_threshold),
"failed": sum(1 for r in results if not r.meets_threshold and not r.error),
"errors": sum(1 for r in results if r.error),
}
print(json.dumps(output, indent=2))
else:
print(report)
# Exit code: 0 if all pass, 1 if any fail/error
if any(not r.meets_threshold or r.error for r in results):
sys.exit(1)
sys.exit(0)
if __name__ == "__main__":
main()

View File

@@ -9,8 +9,8 @@ Scans wizard environments for:
Usage:
python scripts/forge_health_check.py /root/wizards
python scripts/forge_health_check.py $HERMES_WIZARDS_ROOT --json
python scripts/forge_health_check.py --fix-permissions
python scripts/forge_health_check.py /root/wizards --json
python scripts/forge_health_check.py /root/wizards --fix-permissions
"""
from __future__ import annotations
@@ -263,7 +263,7 @@ def print_report(report: HealthReport) -> None:
def main(argv: list[str] | None = None) -> int:
parser = argparse.ArgumentParser(description="Forge Health Check")
parser.add_argument("target", nargs="?", default=os.environ.get("HERMES_WIZARDS_ROOT", "/root/wizards"), help="Root path to scan")
parser.add_argument("target", nargs="?", default="/root/wizards", help="Root path to scan")
parser.add_argument("--json", action="store_true", help="Output JSON report")
parser.add_argument("--fix-permissions", action="store_true", help="Auto-fix file permissions")
args = parser.parse_args(argv)

View File

@@ -1,175 +0,0 @@
"""Tests for #350: remote hermes path validation."""
import subprocess
from unittest.mock import MagicMock, patch, PropertyMock
import pytest
from tools.environments.ssh import SSHEnvironment
class TestResolveRemoteHermesPath:
"""Test that resolve_remote_hermes_path checks multiple locations."""
@patch("tools.environments.ssh.SSHEnvironment._establish_connection")
@patch("tools.environments.ssh.SSHEnvironment._detect_remote_home", return_value="/root")
@patch("tools.environments.ssh.SSHEnvironment._sync_skills_and_credentials")
def test_finds_hermes_via_which(self, mock_sync, mock_home, mock_conn):
"""Should return path from `which hermes` when available."""
env = SSHEnvironment.__new__(SSHEnvironment)
env.host = "test-host"
env.user = "root"
env.port = 22
env.key_path = ""
env.control_socket = "/tmp/test.sock"
with patch("subprocess.run") as mock_run:
# First call: which hermes succeeds
mock_run.return_value = MagicMock(
stdout="/usr/local/bin/hermes\n",
returncode=0,
)
path = env.resolve_remote_hermes_path()
assert path == "/usr/local/bin/hermes"
@patch("tools.environments.ssh.SSHEnvironment._establish_connection")
@patch("tools.environments.ssh.SSHEnvironment._detect_remote_home", return_value="/root")
@patch("tools.environments.ssh.SSHEnvironment._sync_skills_and_credentials")
def test_falls_back_to_local_bin(self, mock_sync, mock_home, mock_conn):
"""Should check ~/.local/bin/hermes when which fails."""
env = SSHEnvironment.__new__(SSHEnvironment)
env.host = "test-host"
env.user = "root"
env.port = 22
env.key_path = ""
env.control_socket = "/tmp/test.sock"
call_count = [0]
def mock_run_side_effect(cmd, **kwargs):
call_count[0] += 1
result = MagicMock()
if call_count[0] == 1:
# which hermes fails
result.stdout = ""
result.returncode = 1
elif call_count[0] == 2:
# ~/.local/bin/hermes exists
result.stdout = "/root/.local/bin/hermes\n"
result.returncode = 0
else:
result.stdout = ""
result.returncode = 1
return result
with patch("subprocess.run", side_effect=mock_run_side_effect):
path = env.resolve_remote_hermes_path()
assert path == "/root/.local/bin/hermes"
@patch("tools.environments.ssh.SSHEnvironment._establish_connection")
@patch("tools.environments.ssh.SSHEnvironment._detect_remote_home", return_value="/root")
@patch("tools.environments.ssh.SSHEnvironment._sync_skills_and_credentials")
def test_returns_empty_when_not_found(self, mock_sync, mock_home, mock_conn):
"""Should return empty string when hermes is not found anywhere."""
env = SSHEnvironment.__new__(SSHEnvironment)
env.host = "test-host"
env.user = "root"
env.port = 22
env.key_path = ""
env.control_socket = "/tmp/test.sock"
with patch("subprocess.run") as mock_run:
mock_run.return_value = MagicMock(stdout="", returncode=1)
path = env.resolve_remote_hermes_path()
assert path == ""
class TestValidateRemoteHermes:
"""Test that validate_remote_hermes returns structured results."""
@patch("tools.environments.ssh.SSHEnvironment._establish_connection")
@patch("tools.environments.ssh.SSHEnvironment._detect_remote_home", return_value="/root")
@patch("tools.environments.ssh.SSHEnvironment._sync_skills_and_credentials")
def test_returns_available_when_found(self, mock_sync, mock_home, mock_conn):
env = SSHEnvironment.__new__(SSHEnvironment)
env.host = "test-host"
env.user = "root"
env.port = 22
env.key_path = ""
env.control_socket = "/tmp/test.sock"
call_count = [0]
def mock_run_side_effect(cmd, **kwargs):
call_count[0] += 1
result = MagicMock()
if call_count[0] == 1:
# which hermes
result.stdout = "/root/.local/bin/hermes\n"
result.returncode = 0
elif call_count[0] == 2:
# hermes --version
result.stdout = "hermes-agent 1.0.0\n"
result.returncode = 0
else:
result.stdout = ""
result.returncode = 1
return result
with patch("subprocess.run", side_effect=mock_run_side_effect):
result = env.validate_remote_hermes()
assert result["available"] is True
assert result["path"] == "/root/.local/bin/hermes"
assert "hermes-agent" in result["version"]
assert result["error"] == ""
@patch("tools.environments.ssh.SSHEnvironment._establish_connection")
@patch("tools.environments.ssh.SSHEnvironment._detect_remote_home", return_value="/root")
@patch("tools.environments.ssh.SSHEnvironment._sync_skills_and_credentials")
def test_returns_error_when_not_found(self, mock_sync, mock_home, mock_conn):
env = SSHEnvironment.__new__(SSHEnvironment)
env.host = "test-host"
env.user = "root"
env.port = 22
env.key_path = ""
env.control_socket = "/tmp/test.sock"
with patch("subprocess.run") as mock_run:
mock_run.return_value = MagicMock(stdout="", returncode=1)
result = env.validate_remote_hermes()
assert result["available"] is False
assert "not found" in result["error"]
assert result["path"] == ""
@patch("tools.environments.ssh.SSHEnvironment._establish_connection")
@patch("tools.environments.ssh.SSHEnvironment._detect_remote_home", return_value="/root")
@patch("tools.environments.ssh.SSHEnvironment._sync_skills_and_credentials")
def test_returns_error_when_version_fails(self, mock_sync, mock_home, mock_conn):
env = SSHEnvironment.__new__(SSHEnvironment)
env.host = "test-host"
env.user = "root"
env.port = 22
env.key_path = ""
env.control_socket = "/tmp/test.sock"
call_count = [0]
def mock_run_side_effect(cmd, **kwargs):
call_count[0] += 1
result = MagicMock()
if call_count[0] == 1:
result.stdout = "/root/.local/bin/hermes\n"
result.returncode = 0
elif call_count[0] == 2:
# hermes --version fails
result.stdout = ""
result.returncode = 127
else:
result.stdout = ""
result.returncode = 1
return result
with patch("subprocess.run", side_effect=mock_run_side_effect):
result = env.validate_remote_hermes()
assert result["available"] is False
assert "not executable" in result["error"]

View File

@@ -154,108 +154,6 @@ class SSHEnvironment(PersistentShellMixin, BaseEnvironment):
except Exception as e:
logger.debug("SSH: could not sync skills/credentials: %s", e)
def resolve_remote_hermes_path(self) -> str:
"""Resolve the hermes binary path on the remote host.
Checks in order:
1. `which hermes` (respects PATH, including ~/.local/bin)
2. ~/.local/bin/hermes (standard install location)
3. Common wizard paths: /root/wizards/*/hermes/venv/bin/hermes
Returns the resolved path, or empty string if not found.
"""
# 1. Try which (respects PATH including ~/.local/bin if on PATH)
cmd = self._build_ssh_command()
cmd.append("which hermes 2>/dev/null")
try:
result = subprocess.run(cmd, capture_output=True, text=True, timeout=10)
path = result.stdout.strip()
if path and result.returncode == 0:
logger.debug("SSH: resolved hermes via which: %s", path)
return path
except Exception:
pass
# 2. Try ~/.local/bin/hermes (standard install symlink)
cmd = self._build_ssh_command()
cmd.append("test -x ~/.local/bin/hermes && echo ~/.local/bin/hermes")
try:
result = subprocess.run(cmd, capture_output=True, text=True, timeout=10)
path = result.stdout.strip()
if path and result.returncode == 0:
logger.debug("SSH: resolved hermes at ~/.local/bin/hermes")
return path
except Exception:
pass
# 3. Search common wizard paths
cmd = self._build_ssh_command()
cmd.append(
"find /root/wizards -maxdepth 4 -path '*/hermes/venv/bin/hermes' "
"-executable 2>/dev/null | head -1"
)
try:
result = subprocess.run(cmd, capture_output=True, text=True, timeout=15)
path = result.stdout.strip()
if path and result.returncode == 0:
logger.debug("SSH: resolved hermes at wizard path: %s", path)
return path
except Exception:
pass
logger.warning("SSH: could not resolve hermes binary on %s@%s", self.user, self.host)
return ""
def validate_remote_hermes(self) -> dict:
"""Validate that hermes is available on the remote host.
Returns dict with:
available: bool
path: str (resolved path if found)
version: str (hermes --version output if available)
error: str (error message if not available)
"""
path = self.resolve_remote_hermes_path()
if not path:
return {
"available": False,
"path": "",
"version": "",
"error": (
f"Hermes binary not found on {self.user}@{self.host}. "
f"Checked: which hermes, ~/.local/bin/hermes, /root/wizards/*/hermes/venv/bin/hermes. "
f"Install hermes or fix the PATH."
),
}
# Verify it's executable and get version
cmd = self._build_ssh_command()
cmd.append(f"{path} --version 2>&1 | head -1")
try:
result = subprocess.run(cmd, capture_output=True, text=True, timeout=15)
version = result.stdout.strip()
if result.returncode != 0:
return {
"available": False,
"path": path,
"version": "",
"error": f"Hermes at {path} exists but is not executable (exit code {result.returncode}).",
}
except subprocess.TimeoutExpired:
return {
"available": False,
"path": path,
"version": "",
"error": f"Hermes at {path} timed out on --version check.",
}
return {
"available": True,
"path": path,
"version": version,
"error": "",
}
def execute(self, command: str, cwd: str = "", *,
timeout: int | None = None,
stdin_data: str | None = None) -> dict: