Watchlespeed/Gemini-Config-Checker-
Security & PrivacyTests proxy configs in a signed-in browser to find routes that reach Google AI Studio and Gemini.
What it does
Gemini Config Checker scans proxy configurations and asks the same question a user would: will this route get me into Google AI Studio and Gemini while signed in? A plain HTTP probe marks every live route as healthy, so the tool drives a real Chrome/Edge/Brave profile, signs in, and reads Google's own verdict — an AI Studio redirect to /docs/available-regions, or the "Gemini isn't currently supported in your country" page — as the blocked signal Why a signed-in browser.
It has two modes. Simple tests a batch of your own configs (share links, a subscription URL, base64, or a ready-made free list). Advanced puts a working base config in front and chains free configs behind it, for cases where your Cloudflare config connects but Google rejects its exit. It also embeds an anti-DPI profile that fragments the TLS ClientHello, reproducing the PattN recipe, and can export links, base64 subscriptions, or a full Xray JSON config for v2rayN, PattN or a stock Xray core User guide.
It is aimed at people maintaining proxy configs in filtered networks who need to know which exits Google currently accepts, rather than which ones merely connect.
Quick start
The desktop builds are unsigned, so plan for SmartScreen or Gatekeeper prompts. Get the archive for your platform from Releases.
- Unzip. On Linux install the runtime first:
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0, thentar -xzf gemini-config-checker-desktop_<version>_linux_amd64.tar.gzand run./GeminiConfigChecker. - Start the app, keep Simple mode, and paste configs one per line (
vless://,vmess://,trojan://,ss://, or a subscription URL). Leaving the box empty tests a ready-made free list. - Click Sign in with Google. A separate browser profile opens; sign in there and it closes when detected.
- Press Start scan (or
Ctrl+Enter) and read the Results tab: Healthy, Region blocked, or Error, with per-product AI Studio/Gemini columns and ping. - Use Copy for a share link, or the Export tab to save links, a base64 subscription, or a
.jsonconfig.
No browser or on Android: set the check type to connectivity only in settings. It is faster but only proves the route reaches Google; the region is not checked Settings reference.
Constraints
The region check needs a graphical session and a Chrome, Edge or Brave installation; Flatpak browsers cannot be driven. The app has been run end to end only on Windows — macOS, Linux and Android builds come from CI and have not been exercised on real devices Download and install. The Android APK is connectivity-only because Android cannot drive a signed-in Chromium.
Each browser check uses roughly 200 MB of RAM and takes 20–40 s per config, with defaults of 4 concurrent browser checks and 60 configs per scan. A verdict is a sample, not a guarantee: Cloudflare Worker exits can change between connections, so a passing route may fail later and should be re-tested.
The anti-DPI profile only helps inside filtered networks and adds latency elsewhere; only fragment masks are supported. The web server build listens on 127.0.0.1:8787 and has no authentication, so keep it on localhost or tunnel it. Sign-in cookies stay in memory in an isolated profile; configs are stored locally only when "remember" is ticked Privacy and security. Free configs are run by unknown operators, so sensitive traffic should not go through them. The project is MIT-licensed, with Xray-core and fonts under their own licenses.
HotRepo's take
On 2026-11-15 the repository entered the new-project list with 288 stars gained in a window of about 1.5 hours and no forks, and it has no recorded GitHub daily rank. A single snapshot of that short window supports only the fact that attention arrived quickly; it does not establish sustained interest or the tool's reliability. What the README does show is a concrete mechanism — signed-in browser checks instead of HTTP probes — plus an inverted-platform caveat: Windows is the only platform run end to end, while the macOS, Linux and Android builds are untested CI artifacts. The download banner at the top pointing to a Dropbox .rar for a "Gemini app" sits oddly against the actual desktop release flow and is worth checking before trusting any package.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- UniteSupporter/Gemini-Config-Checker-Tests proxy configs for access to Google AI Studio and Gemini using a signed-in browser check.
- TurtleReside/Gemini-Config-Checker-Scans proxy configs to find ones that reach Google AI Studio and Gemini from a signed-in browser.
- visionguruoutfit/Gemini-Config-Checker-Tests proxy configs against Google AI Studio and Gemini in a signed-in browser and exports working routes.
- VoltBrewerCeiling/Gemini-Config-Checker-Test proxy configs in a signed-in browser to see whether they 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.