Skip to content

Open-source, desktop app to validate API keys for OpenAI, Gemini, YouTube, and custom endpoints. Run bulk checks. Import keys from TXT/CSV/JSON, export to CSV/JSON. UI in English, Russian, and Spanish. Builds for macOS, Windows, and Linux. Electron + React. Works locally, without telemetry. Simple to use.

License

Notifications You must be signed in to change notification settings

nbox/API-Key-Health-Checker

Repository files navigation

API Key Health Checker logo

API Key Health Checker

🌐 Read in: English | Русский | Español

Desktop app to validate API keys for popular services and run batch checks with rate limits and reports. Supports OpenAI (ChatGPT), Google Gemini, YouTube Data API, and custom endpoints.

Screenshot

🍺 Homebrew (macOS)

Install:

brew install --cask nbox/tap/api-key-health-checker

Uninstall:

brew uninstall --cask --zap api-key-health-checker

Download

Releases: https://github.com/nbox/API-Key-Health-Checker/releases

macOS Gatekeeper

⚠️ macOS may block unsigned builds downloaded from GitHub. If you see the message "app is damaged and can't be opened. You should move it to the Trash", run:

xattr -dr com.apple.quarantine "/Applications/API Key Health Checker.app"

Features

  • Service adapters: OpenAI, Gemini, YouTube, Custom
  • Batch checks with concurrency, random delay (jitter), retries, global RPS limiter
  • Multiple parallel runs with live logs, stats, and summary
  • Import keys from TXT/CSV/JSON, encoding selection, dedupe, format warnings
  • Export reports to CSV/JSON (masked or full)
  • UI languages: English (default), Russian, Spanish

Security and privacy

  • Keys are sent only to the selected API endpoint
  • No telemetry
  • Use only keys you own or have permission to test
  • Full export saves plain text keys (no encryption). Handle with care.

Requirements

  • Node.js 20+
  • npm

Quick start

npm install
npm run dev

Build

git clone https://github.com/nbox/API-Key-Health-Checker.git
cd API-Key-Health-Checker
npm install
npm run build
npm run dist

Build output is written to dist/. DMG output: release/API Key Health Checker-1.0.0-{arch}.dmg. macOS build: run npm run dist on macOS to generate a .dmg in release/. Windows build: run npm run dist on Windows to generate a .exe installer in release/.

GitHub Actions release

  • On push to main or tags v*
  • Builds for macOS, Windows, and Linux
  • Creates a GitHub Release with artifacts

Custom service

Use the Custom adapter to define a base URL, path, auth type (bearer/header/query), and success status codes.

Project structure

  • src/main: Electron main process and execution engine
  • src/renderer: UI (React + Tailwind)
  • src/shared: shared types and utilities

About

Open-source, desktop app to validate API keys for OpenAI, Gemini, YouTube, and custom endpoints. Run bulk checks. Import keys from TXT/CSV/JSON, export to CSV/JSON. UI in English, Russian, and Spanish. Builds for macOS, Windows, and Linux. Electron + React. Works locally, without telemetry. Simple to use.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published