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.3.0.tar.gz (826.5 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.3.0-py3-none-any.whl (705.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: local_bench_ai-0.3.0.tar.gz
  • Upload date:
  • Size: 826.5 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.3.0.tar.gz
Algorithm Hash digest
SHA256 8ef1e0623c11befa717e2a4ffefa939fe5569e1fd02fb5a48c45b06b2248ddf4
MD5 d778f3bad8dbe88d47b2e055a0dd7a06
BLAKE2b-256 523ff67af65ed925edbc80a2e6649e0ff275053710e9a030f0ae0f7107737b67

See more details on using hashes here.

File details

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

File metadata

  • Download URL: local_bench_ai-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 705.9 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.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b010eb51520503d57d027ada3fd1d4ee0d7ef2a491a99548705b83e84c6d2670
MD5 cba01c5932af0c4a71f8bd68084a8eab
BLAKE2b-256 d14b9f9b339538ad228f5aea18d0b1695f549495c618c4cd189eacbc7eb3c10e

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