Skip to main content

Benchmark runner for local-bench.ai - the community quality leaderboard for local AI setups.

Project description

local-bench-ai

CLI benchmark runner for local-bench.ai — a community quality leaderboard for local AI setups. It benchmarks GGUF models served by llama.cpp (or any OpenAI-compatible endpoint), scores them on the six-axis Local Intelligence Index (Agentic, Knowledge, Instruction-Following, Tool calling, execution-verified Coding, Math), and packs signed, reproducible result bundles you can submit for maintainer review.

Quickstart

pip install "local-bench-ai[hf]"   # Python 3.11+

# 1. Fetch the ranked suite from the site (hash-verified)
localbench fetch-suite --site https://local-bench.ai \
  --suite suite-v1-full-exec-6axis-v1 --accept-suite-terms

# 2. Cache the tokenizer/chat template for offline identity
localbench cache-tokenizer <hf-model-id>

# 3. Strongest provenance: the CLI launches the pinned llama.cpp server itself
localbench bench \
  --runtime llama.cpp --server-bin <path-to-llama-server> \
  --model-file <model.gguf> --model-id <model-slug> \
  --hf-model-id <hf-model-id> \
  --suite full-exec-6axis-v1 --bench all \
  --lane bounded-final-v2 --profile auto --tier standard \
  --ctx 32768 --seed 1234 --out runs/my-bench

# 4. Submit for maintainer review (nothing auto-publishes)
localbench submit run --run runs/my-bench

The site's submit page generates these commands for your exact model and runtime, including the full identity flag set for bring-your-own-server runs. Publishable bounded-final-v2 runs require a 32k server context.

What makes rows trustworthy

  • Suites are hash-pinned releases; sampler settings are pinned (greedy, seeded).
  • Coding is BigCodeBench-Hard, re-executed by the maintainer's sandbox verifier before it can rank; community agentic results are labeled self-reported.
  • Every number on the board links to a receipt with the full run manifest.
  • Nothing ranks without maintainer review.

Methodology: https://local-bench.ai/methodology

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

local_bench_ai-0.2.5.tar.gz (819.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

local_bench_ai-0.2.5-py3-none-any.whl (701.8 kB view details)

Uploaded Python 3

File details

Details for the file local_bench_ai-0.2.5.tar.gz.

File metadata

  • Download URL: local_bench_ai-0.2.5.tar.gz
  • Upload date:
  • Size: 819.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for local_bench_ai-0.2.5.tar.gz
Algorithm Hash digest
SHA256 1fc42abf45ce4af520a4b1511554e6760f3dfd4bffa7b8815e86b65e7e50e8fb
MD5 b8dca80b2ce459a89dae7d9f7a150ea4
BLAKE2b-256 4026cf084bd9cbda6e72b5e13fe37777b48a6c8b7f52c9bef4e61e14175989f9

See more details on using hashes here.

File details

Details for the file local_bench_ai-0.2.5-py3-none-any.whl.

File metadata

  • Download URL: local_bench_ai-0.2.5-py3-none-any.whl
  • Upload date:
  • Size: 701.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for local_bench_ai-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f8150ffad8db59ad5d99cadcc461052ea795de915848ddcbd09c4c090347d936
MD5 9f37b39b2524e6a30716836894ae5e38
BLAKE2b-256 27fb8e5ee43192455e54beb0a9eb02934b6aa9758b5915bc5c802eb9379fe411

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page