BLXBench Docs
BLXBench Docs
LeaderboardOur TestsSponsor / PartnershipDocumentationInstallationUpdating blxbenchQuick StartTUIArcadeCommandsHeadless ModeConfigurationLeaderboardOur TestsAccountReport Browser (desktop)AboutFAQSupport

Account

Managing your BLXBench account, API keys, billing, and security.

Creating an Account

  1. Open the site and choose Sign Up
  2. Enter email and password
  3. Complete email verification when prompted

Pass tiers (billing)

BLXBench uses Runner, Scout, Bencher, and Founder passes (see /pass for tiers and checkout on the web):

  • Runner — Free: download blxbench, run benchmarks locally, keep reports private
  • Scout — $4/month or $40/year: includes 2 public leaderboard submissions per model per ISO week (UTC)
  • Bencher — $8/month or $80/year: includes 5 public leaderboard submissions per model per ISO week (UTC)
  • Founder — $16/month or $160/year: includes 10 public leaderboard submissions per model per ISO week (UTC) and additional benefits described on the pass page

Submitting reports with --submit requires an API key and a tier that includes submission quota.

Usage in the CLI (/usage / /pass)

After /auth login in blxbench, run /usage or /pass to open an overlay with your account, pass / subscription summary, and weekly public bench quota per model (peak usage vs cap, optional per-model breakdown, UTC reset). Data comes from the same /api/cli/me payload the CLI already uses — self-hosted deployments should expose benchWeekly (including limitPerModel / usageByModel when possible, plus legacy used / limit) in that response if you want the meter to show real numbers; otherwise the overlay may omit or simplify quota. Admin accounts are treated as unlimited when the API does not send a finite limit.

For buying or comparing tiers in a browser, use /pass; the slash commands are terminal-only.

API Keys

Create keys for headless automation and leaderboard submit:

  1. Open Account → API Keys
  2. Generate a new key
  3. Store it in a secret manager — it is shown once

These keys are different from provider keys (OPENROUTER_API_KEY, etc.). Optional: store provider keys in ~/.blxbench/config.json → env (see Configuration — App config file) or in .env; use BLXBENCH_API_KEY (or Account device login) only for BLXBench account features and uploads.

Using API Keys

export BLXBENCH_API_KEY=your-key

blxbench --headless --provider opr --models openai/gpt-5.4-mini --submit

blxbench sign-in (TUI)

For interactive login from the terminal, run /auth login in the TUI. blxbench opens the device login page so you can approve the code in the browser. This creates local blxbench credentials; it is separate from manually generated API keys.

With an eligible pass and role, you can upload from the TUI in three ways: /report submit on (auto-upload when the run finishes), s or r on the post-run screen (manual upload of the new report, regardless of that setting), or /report list to select an earlier report.json and upload it from the replay view. See TUI and Commands.

Security

Password

Change your password under Account → Security (Password tab).

Passkeys

Add WebAuthn passkeys on the same page for passwordless sign-in.

Two-Factor Authentication (2FA)

Enable TOTP on Account → Security (Two-factor tab) using an authenticator app.

Sessions

Review and revoke active sessions from the Sessions tab.

Billing

Account → Billing shows plan status, Stripe checkout history where applicable, invoices, and related activity.

Profile

Account is the profile hub: name, avatar, email visibility, and verification status.

Delete Account

  1. Go to Account → Security
  2. Open the Danger zone tab
  3. Follow the delete-account flow and confirm

This cannot be undone.

Our Tests

Explore the BLXBench test catalog and understand test categories.

Report Browser (desktop)

Optional BLXBench Report Browser — browse local benchmark HTML reports, leaderboard aggregates, and run detail in a desktop window.

On this page

Creating an AccountPass tiers (billing)Usage in the CLI (/usage / /pass)API KeysUsing API Keysblxbench sign-in (TUI)SecurityPasswordPasskeysTwo-Factor Authentication (2FA)SessionsBillingProfileDelete Account