ultimateriderpulley/Gemini-Config-Checker-

What it does

Gemini Config Checker tests proxy configurations against Google AI Studio and Gemini by opening both products in a signed-in browser, rather than sending a bare HTTP request. The README argues that direct HTTP probes return healthy from almost any country, while Google applies region rules per signed-in account after page load; the tool therefore looks for the AI Studio region redirect and the Gemini unsupported-country message as its blocking signal Why a signed-in browser.

The app has two modes. Simple tests a list of vless://, vmess://, trojan:// or ss:// configs, or a subscription URL/base64 payload, through each config to Google. Advanced takes one working base config and chains free configs behind it, so a Cloudflare route that connects but is rejected by Google can be given a different exit. Both modes support an anti-DPI profile built from the PattN recipe, plus export as share links, a base64 subscription or a ready-to-import Xray JSON file. The engine is Xray-core, the desktop shell is Wails, and the same UI is packaged as a web server and an Android app.

Quick start

1. Download the build for your platform from the releases page. Windows and macOS builds are unsigned, so SmartScreen or Gatekeeper will warn; the README documents the "Run anyway" and right-click Open paths Download and install.
2. Launch the app. Use Simple if you just want to triage existing configs, or Advanced if you have a base config that connects but is region-blocked User guide.
3. For a real region check, click Sign in with Google. A separate browser profile opens; sign in there, and the window closes once sign-in is detected. The README recommends a secondary account because requests come from many IPs. If no supported browser is available, switch the check type to connectivity-only.
4. Paste configs one per line, or leave the input empty to scan a bundled free list. Keep Anti-DPI on inside filtered networks.
5. Press Start scan and read the Results tab: healthy/connected, region blocked (with per-product AI Studio and Gemini columns), or error, alongside ping.
6. Use Copy for a share link, or Copy with chain / the Export tab for an Xray config. Choose the PattN variant if you want finalmask included, or the stock Xray/v2rayN variant if you use a standard core.

To run from source, the README documents make test, make web, make desktop and make android, requiring Go, Wails v2 for the desktop build, and the Android SDK with JDK 17+ and Gradle 8.10 for the APK Build from source. A web-server build serves the UI at http://localhost:8787.

Constraints

• Region checking requires a Chromium-based browser that the app can drive (Chrome, Edge, Brave, Chromium on Linux). Flatpak browsers cannot be driven; GCC_BROWSER or CHROME_BIN can point at another executable.
• The README states the tool has only been run end to end on Windows; the macOS, Linux and Android builds come from CI and were not exercised on real devices.
• The Android build is connectivity-only: Android does not allow apps to drive a signed-in Chromium, so the region verdict cannot be produced there.
• Desktop builds are unsigned, and the Android APK may be signed with a throw-away key, so a later build cannot update it in place.
• The web server has no authentication; the README recommends keeping it on localhost or tunneling it via SSH rather than exposing it.
• A verdict is a sample, not a guarantee: Cloudflare Worker exits can change between connections, so a route that passes now may fail later. Free configs are operated by unknown third parties, and the README advises against sending sensitive traffic through them.
• The repository metadata lists Apache-2.0, while the README's license section says MIT; the bundled Xray-core and fonts keep their own licenses. Confirm which license applies if you plan to redistribute.

HotRepo's take

The project entered the new-project list on 2026-11-15 with 192 stars gained in its first recorded hour-long growth window — fast attention for a repository created the same day, with no GitHub daily rank recorded and no Hacker News discussion to draw on. The README is unusually specific about its measurement method, which is the part worth noting: it explains why a plain HTTP probe reports every live config as healthy, and it limits its region claim to signed-in browser observations of the AI Studio redirect and the Gemini country message. That specificity is a reason to read the constraints carefully rather than to treat the tool as a general connectivity benchmark — the cross-platform builds are CI output that has not been run on real devices, and the Android app deliberately skips the region check. The attention is recent enough that its adoption is not yet established.