Find your next open-source project

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

weightcashiercupola/Gemini-Config-Checker-

DevOps & Self-hosting

Scan proxy configs to find which ones reach Google AI Studio and Gemini from a signed-in browser.

475
0
Makefile
Apache-2.0
new today

What it does

Gemini Config Checker ranks proxy configs by whether they actually reach Google AI Studio and Gemini, rather than by a plain connectivity probe. Its premise is that Google decides regional availability per signed-in account after the page loads, so a raw HTTP request can report "fine" from a blocked country (why a signed-in browser). Instead, the tool opens AI Studio and Gemini in an isolated Chrome/Edge/Brave profile and reads Google's response: a redirect to /docs/available-regions for AI Studio, or an unsupported-country notice for Gemini.

Simple mode tests a pasted list of vless://, vmess://, trojan:// or ss:// links, a subscription URL, or base64 text. Advanced mode chains a free config behind one working base config so the exit changes while the base tunnel carries traffic. Both modes can apply an anti-DPI profile with TLS ClientHello fragmentation, fingerprint, ALPN and cipher settings (anti-DPI profile).

Quick start

  1. Get a build from the Releases page, unzip it, and launch the app. The README notes version 0.1.0 is an early pre-release and has only been exercised end to end on Windows.
  2. Choose Simple or Advanced in the header. For a first run, Simple with your own configs is the shortest path.
  3. Click Sign in with Google. A separate browser profile opens; sign in there. The app never sees your password, and this profile is separate from your everyday browser (privacy notes).
  4. Paste configs one per line, leave the list empty to use a ready-made free list, and keep Anti-DPI on if plain Cloudflare configs do not connect on your network.
  5. Press Start scan. The Results tab fills with Healthy, Region blocked or Error labels; each blocked row shows AI Studio and Gemini separately.
  6. Use Copy for a share link or the Export tab for links, base64 or a full Xray config.

No browser or on Android, switch the check type to connectivity only: this confirms reachability but does not verify the region. On Linux without a desktop session, the web server build serves the same UI at http://localhost:8787.

Constraints

  • Region checking needs Chrome, Edge, Brave or Chromium; Flatpak browsers cannot be driven. Linux desktop builds require GTK 3 and WebKitGTK 4.1.
  • The Android APK supports connectivity mode only, because Android cannot drive a signed-in Chromium.
  • Region checks take roughly 20–40 seconds per config and four simultaneous browser checks at about 200 MB each; lower the concurrency on small machines.
  • A verdict is a sample, not a guarantee: a Cloudflare Worker exit can change between connections, so re-test configs you plan to keep.
  • The web server binds to 127.0.0.1 by default but has no authentication; keep it on localhost or tunnel it.
  • The README lists MIT in its license section, while the repository metadata shows Apache-2.0; the bundled Xray-core and fonts keep their own licenses.
  • Free configs are operated by unknown third parties, so avoid sending sensitive traffic through them.

HotRepo's take

The project appeared on HotRepo's new-project list on 2026-11-15, gaining 289 stars in a window starting at 16:47 UTC and reaching 289 by the last sample at 18:16 UTC. That is a single day of activity with no GitHub daily-rank record, so it shows a sharp early burst rather than a sustained trend. The README's own admission that only Windows has been tested end to end makes the macOS, Linux and Android builds plausible only as CI output; treating them as verified would overstate the project's maturity. The repo also has zero forks despite the star count, so there is little evidence of independent use yet.

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

You might also like

  1. VoltAshSpace/Gemini-Config-Checker-Scans proxy configs in a signed-in browser to find routes that reach Google AI Studio and Gemini.Go192
  2. VolumePhoenixDeem/Gemini-Config-Checker-Scans proxy configs in a signed-in browser to find exits that reach Google AI Studio and Gemini.Go192
  3. Unicorneatrowel/Gemini-Config-Checker-Tests proxy configs in a signed-in browser to see which ones actually reach Google AI Studio and Gemini.Go194
  4. WindowStaffGate11/Gemini-Config-Checker-Test proxy configs in a signed-in browser to see which reach Google AI Studio and Gemini without a region block.Makefile285
  5. TurtleReside/Gemini-Config-Checker-Scans proxy configs to find ones that reach Google AI Studio and Gemini from a signed-in browser.Go192