Find your next open-source project

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

TypeTyrantScheme/Gemini-Config-Checker-

Security & Privacy

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

475
0
Makefile
Apache-2.0
new today

What It Does

Google decides Gemini and AI Studio availability per signed-in account after the page loads, so a plain HTTP probe reports every live config as healthy even when the region is blocked. This tool tests each proxy config the way a user would: through a signed-in Chrome, Edge or Brave profile, reading Google's actual verdict.

There are two modes. Simple checks a list of configs you already have (share links, a subscription URL, base64 or a ready-made free list). Advanced chains free configs behind one working base config so the base's exit can be replaced when Google blocks it. An optional anti-DPI profile applies fragmentation, fingerprint, ALPN and cipher settings aimed at filtered networks.

It is intended for users who select or validate proxy routes for Google AI services, not for general network diagnostics.

Getting Started

  1. Download the build for your platform from the Releases page. Every release includes SHA256SUMS.txt; check it before running.
  2. Pick a mode with the header switch. For Simple, paste configs one per line (vless://, vmess://, trojan://, ss://), a subscription URL or base64 text, or leave the box empty to scan a bundled free list.
  3. Click Sign in with Google. A separate browser profile opens; sign in normally and the window closes once sign-in is detected. A secondary account is recommended because requests come from many IPs.
  4. Keep Anti-DPI on only if plain Cloudflare configs do not connect on your network.
  5. Press Start scan. Connectivity tests run first, then browser region checks; results show Healthy, Region blocked or Error with per-product status.
  6. Use Copy, Copy with chain or the Export tab to move the chosen config into v2rayN, Hiddify, PattN or another Xray-compatible client.

No browser or Android: switch the check type to connectivity only, which confirms reachability and latency but does not verify the region.

Constraints

The tool is version 0.1.0 and has only been run end to end on Windows; macOS, Linux and Android builds come from CI and have not been exercised on real devices. Region checks require Chrome, Edge, Brave or Chromium; Flatpak browsers cannot be driven. Each simultaneous browser check uses roughly 200 MB of RAM, and region mode takes 20–40 seconds per config.

The Android APK supports connectivity mode only, because apps cannot drive a signed-in Chromium. Desktop builds are unsigned, so Windows SmartScreen and macOS Gatekeeper will warn.

The local web server has no authentication and should stay bound to localhost or be reached over an SSH tunnel. Configs and settings are stored locally only when "remember" is enabled. Free configs are run by unknown third parties, so sensitive traffic should not pass through them.

The README's license section says MIT, but the repository metadata lists Apache-2.0; the bundled Xray-core and fonts retain their own licenses.

A verdict is a sample: Cloudflare Worker exits can change between connections, so re-test any config before relying on it.

HotRepo's take

The project entered HotRepo's new-project list on 2026-11-15 with 192 stars gained in roughly one hour, its first recorded day. That is a fast start on a single snapshot and does not by itself establish sustained traction. The technical premise is specific and measurable: Google's per-account region rules mean connectivity probes are insufficient, and the README documents the blocked-page signatures for AI Studio and Gemini. The main caveat is delivery — the top of the README links a Dropbox .rar download while the install section points to GitHub Releases, and the binary artifacts remain unverified here.

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

You might also like

  1. WingDataVacuum/Gemini-Config-Checker-Test proxy configs in a signed-in browser to see which ones actually reach Google AI Studio and Gemini.Makefile281
  2. Violetnyudress/Gemini-Config-Checker-Tests proxy config chains to see which ones reach Google AI Studio and Gemini in a signed-in browser.Go194
  3. ultimateriderpulley/Gemini-Config-Checker-Scans proxy configs by signed-in browser checks to see which ones can actually reach Google AI Studio and Gemini.Go198
  4. TurtleReside/Gemini-Config-Checker-Scans proxy configs to find ones that reach Google AI Studio and Gemini from a signed-in browser.Go192
  5. wisemeadowlarkspike/Gemini-Config-Checker-Scans proxy configs by testing them in a signed-in browser to see which reach Google AI Studio and Gemini.Go275