VoltBrewerCeiling/Gemini-Config-Checker-

What It Does

Gemini Config Checker tests proxy configurations by actually loading Google AI Studio and Gemini in a separate browser profile where you are signed in. The project argues that plain HTTP probes cannot detect Google's regional restrictions, because those restrictions only appear after sign-in page load (Why a signed-in browser). It supports VLESS, VMess, Trojan and Shadowsocks links, subscription URLs and base64 bundles, and reports each config as healthy, region blocked or errored.

There are two operating modes. Simple tests the configs you supply, or a ready-made free list. Advanced takes one working base config and chains free configs behind it, so the exit seen by Google changes while your own base route stays in place. An optional anti-DPI profile applies fragmentation and TLS settings intended for filtered networks. The engine is built on Xray-core, with Wails desktop shells and a web server sharing the same UI (project layout).

Quick Start

1. Download the desktop build for your platform from Releases. The README also lists a Dropbox .rar download badge at the top, but that archive is not described as part of the normal release process; prefer the GitHub release assets and their SHA256SUMS.txt.
2. Unzip and run the app. Windows builds are unsigned, so SmartScreen may warn; macOS users may need right-click → Open or to remove the quarantine attribute (install notes).
3. In Simple mode, paste configs one per line into the input box, or leave it empty to test a built-in free list. Keep Anti-DPI on only if plain Cloudflare configs do not connect in your network.
4. Click Sign in with Google. A separate Chrome, Edge or Brave profile opens; sign in there, and the app detects completion and closes the window. A secondary Google account is suggested because requests come from many IPs.
5. Press Start scan and watch the Results tab. A config marked healthy passed your chosen rule for AI Studio and Gemini; region-blocked entries show which product failed. Use Copy or the Export tab to move a config into your proxy client.

If no supported browser is installed or you are on Android, switch the check type to connectivity only; this verifies reachability and latency but does not check the region.

Constraints

The signed-in region check requires Chrome, Edge, Brave or Chromium and a graphical session; Flatpak browsers cannot be driven. Region mode takes roughly 20–40 seconds per config and uses about 200 MB of RAM per concurrent browser check. Android builds only support connectivity mode. The web server binds to localhost and has no authentication, so do not expose it directly (privacy notes). Free configs are operated by unknown third parties; do not send sensitive traffic through them. A result is a sample: a Cloudflare Worker exit can change between connections, so re-test before relying on a config. The README states MIT for the repository, with Xray-core under MPL-2.0 and bundled fonts under SIL OFL.

HotRepo's Take

The project entered HotRepo's new-project list on 2026-11-15 with 192 stars gained in a one-hour observation window, all within its first day. That is a very short record, and no daily all-language rank was captured. The technical premise is specific: reading Google's signed-in regional verdict instead of trusting HTTP reachability, plus chained routing for changing exits. The weakest point for new users is distribution: the README mixes GitHub release builds with an unexplained Dropbox archive, and the desktop binaries are unsigned. Verify checksums and build from source if possible before running it.