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.4.tar.gz (794.4 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.4-py3-none-any.whl (680.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: local_bench_ai-0.2.4.tar.gz
  • Upload date:
  • Size: 794.4 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.4.tar.gz
Algorithm Hash digest
SHA256 eaf4fc294c2ef53dd81e58d56e77492d5c9aeef7e11c53111a648ec8d784f5e3
MD5 95341d67cc62082a277de5d7fb61fa77
BLAKE2b-256 663f064d5ea8a01c06c54a23dff77eb25c4130c5f399d66c450c30f9616ef9d6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: local_bench_ai-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 680.1 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 afaec63842bad2e9197b5ab38ffc7752ab28bf9284a8846ab6f9b4d4bf6d7b0d
MD5 99e03d5896ca040397ebde45c607a86b
BLAKE2b-256 bb0299190b560c8525aeae1f223651bcc93446337a8ac5ddf80dca6af92d86fe

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