Account
Managing your BLXBench account, API keys, billing, and security.
Creating an Account
- Open the site and choose Sign Up
- Enter email and password
- 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/monthor$40/year: includes 2 public leaderboard submissions per model per ISO week (UTC) - Bencher —
$8/monthor$80/year: includes 5 public leaderboard submissions per model per ISO week (UTC) - Founder —
$16/monthor$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:
- Open Account → API Keys
- Generate a new key
- 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 --submitblxbench 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
- Go to Account → Security
- Open the Danger zone tab
- Follow the delete-account flow and confirm
This cannot be undone.