Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

WerewolfEmuHub/Gemini-Config-Checker-

Productivity & Utilities

Tests proxy configs in a signed-in browser to see which ones reach Google AI Studio and Gemini.

475
0
Go
Apache-2.0
new today

What it does

Google decides whether AI Studio and Gemini are available per signed-in account after the page loads, so a plain HTTP probe can mark every live config as healthy. This tool instead opens AI Studio and Gemini through each proxy config in an isolated signed-in Chrome/Edge/Brave profile and reads what Google actually shows: a redirect to /docs/available-regions for AI Studio, or the "not supported in your country" message for Gemini (why a signed-in browser).

Simple mode tests configs you supply (share links, a subscription URL, or base64) or a ready-made free list, applying an optional anti-DPI fragmenting profile. Advanced mode chains free configs behind one working base config so a Cloudflare exit that Google rejects can be swapped for another. Results can be exported as links, a base64 subscription, or an Xray JSON config, with an option to strip the finalmask field for stock Xray/v2rayN cores (user guide).

Quick start

  1. Download a build for your platform from Releases. The Windows desktop package is a zip containing GeminiConfigChecker.exe; WebView2 is already present on Windows 10/11. The builds are unsigned, so SmartScreen or Gatekeeper will warn.
  2. Launch the app and open the Scan tab. Leave the mode on Simple to check your own configs.
  3. Paste one config per line (vless://, vmess://, trojan://, ss://), a subscription URL, or base64 text; or leave the box empty and pick a ready-made list.
  4. Click Sign in with Google. A separate browser profile opens; sign in there, and the window closes once the session is detected. Choose connectivity only in Settings if you have no browser or are on Android.
  5. Press Start scan and watch the Results tab. Use the Export tab to copy links, a base64 subscription, or a full Xray config.

Constraints

  • Region checking needs Chrome, Edge, Brave, Chromium, Opera or Vivaldi and a graphical session; Flatpak browsers cannot be driven. Android only offers connectivity-only mode because apps cannot drive a signed-in Chromium.
  • The README reports that the app has only been exercised end to end on Windows; macOS, Linux and Android builds come from CI and have not been run on real devices (download and install).
  • Region checks take roughly 20–40 seconds per config, and each simultaneous browser check uses about 200 MB of RAM; the default cap is 60 configs and 4 parallel browser checks.
  • The web server build has no authentication and binds to 127.0.0.1; keep it on localhost or tunnel it.
  • A verdict is a sample: Cloudflare Worker exits can change between connections, so a config may pass and then fail minutes later.
  • Free configs are operated by unknown third parties; the README advises not sending sensitive traffic through them.
  • The repository states MIT while the bundled Xray-core and fonts keep their own licenses (license).

HotRepo's take

The repository appeared on the new-project list on 2026-11-15, recording 282 stars in a growth window of about 1.5 hours since 16:47 UTC; the star curve shows roughly 186 to 282 stars between 17:46 and 18:16 that day. There is no all-language daily rank record and no HN discussion, so the numbers describe one short spike rather than a sustained trend. The technical premise—checking region access as a signed-in user instead of by HTTP probing—is what distinguishes it from ordinary config pingers; whether the macOS, Linux and Android builds work as advertised is explicitly untested by the author. Note also that the README's top download button points to a Dropbox .rar archive while the text directs users to GitHub Releases, a mismatch worth resolving before running any binary.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. YellowLaborerMarket/Gemini-Config-Checker-Tests proxy configs in a signed-in browser to see which ones reach Google AI Studio and Gemini.Makefile272
  2. VisionWormStudio/Gemini-Config-Checker-Scans proxy configs to find ones that actually reach Google AI Studio and Gemini for a signed-in user.Go193
  3. Updatedelcure/Gemini-Config-Checker-Tests proxy configs for whether a signed-in Google account can reach AI Studio and Gemini.Makefile200
  4. TrooperFilter/Gemini-Config-Checker-Scan proxy configs in a signed-in browser to find routes that reach Google AI Studio and Gemini.Makefile192
  5. Violetnyudress/Gemini-Config-Checker-Tests proxy config chains to see which ones reach Google AI Studio and Gemini in a signed-in browser.Go194