WerewolfEmuHub/Gemini-Config-Checker-
Productivity & UtilitiesTests proxy configs in a signed-in browser to see which ones reach Google AI Studio and Gemini.
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
- 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. - Launch the app and open the Scan tab. Leave the mode on Simple to check your own configs.
- 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. - 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.
- 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
- YellowLaborerMarket/Gemini-Config-Checker-Tests proxy configs in a signed-in browser to see which ones reach Google AI Studio and Gemini.
- VisionWormStudio/Gemini-Config-Checker-Scans proxy configs to find ones that actually reach Google AI Studio and Gemini for a signed-in user.
- Updatedelcure/Gemini-Config-Checker-Tests proxy configs for whether a signed-in Google account can reach AI Studio and Gemini.
- TrooperFilter/Gemini-Config-Checker-Scan proxy configs in a signed-in browser to find routes that reach Google AI Studio and Gemini.
- Violetnyudress/Gemini-Config-Checker-Tests proxy config chains to see which ones reach Google AI Studio and Gemini in a signed-in browser.