Violetnyudress/Gemini-Config-Checker-

What It Does

Gemini Config Checker tests proxy configurations against Google AI Studio and Gemini and reports which ones actually work. The key design choice is that it judges region availability the way a user does: it opens a separate signed-in Chrome/Edge/Brave profile and reads what Google shows. The README argues plain HTTP probes are useless here, because API requests return fine from every country while a signed-in page may show a region wall (why a signed-in browser).

Two modes share one switch. Simple tests a list of configs you supply (or a ready-made free list) and reports per-config results. Advanced takes one working base config and chains free configs behind it, so a Cloudflare exit that Google blocks can be replaced by another exit. The anti-DPI profile is based on the PattN recipe and adds TLS ClientHello fragmenting through a local forwarder (anti-DPI profile).

It is aimed at people who already work with vless/vmess/trojan/ss links and need to verify which route gets them into AI Studio and Gemini, not at users looking for a general proxy client.

Quick Start

1. Get a build for your platform from the Releases page; releases ship SHA256SUMS.txt, and the desktop builds are unsigned (download and install).
2. Launch the app. On Windows unzip and run GeminiConfigChecker.exe; on Linux install libgtk-3-0 and libwebkit2gtk-4.1-0 first. The web-server build serves the same UI on http://localhost:8787.
3. Pick Simple or Advanced in the header.
4. In Simple, paste configs one per line (subscription URLs and base64 also accepted), or leave the box empty to scan a ready-made free list.
5. Choose the check type. Region with signed-in browser opens a dedicated browser profile; sign in to Google once. The app never sees your password, and the profile is separate from your everyday browser (user guide). Connectivity only skips sign-in and only proves the route reaches Google.
6. Press Start scan and read the Results tab: healthy, region blocked, or error, with per-product AI Studio and Gemini columns and ping.
7. Use Copy for a share link, or the Export tab for links, base64, or an Xray JSON config. Pick PattN/PattNG if you want finalmask retained, or standard Xray/v2rayN if not.

Constraints

• Region checks need Chrome, Edge, Brave, Chromium or Vivaldi and take roughly 20–40 s per config; each concurrent browser check uses about 200 MB of RAM.
• Android runs connectivity-only mode because Android cannot drive a signed-in Chromium, so region is not verified there.
• The macOS, Linux and Android builds come from CI and, per the README, had not been exercised on real devices at the time of writing; only Windows has run end to end.
• The web server has no authentication. Keep it on localhost or tunnel it rather than exposing it.
• A verdict is a sample: a Cloudflare Worker exit can change between connections, so re-test before relying on a result. Free configs are operated by unknown parties; do not send sensitive traffic through them.
• The repository is Apache-2.0 per GitHub metadata, while the README's license section says MIT and notes the bundled Xray-core and fonts keep their own licenses.

Distribution Notes

The README's top banner links a Dropbox-hosted .rar download alongside the Releases page, which is not the documented install path. Treat the Releases page and SHA256SUMS.txt as the intended source, and verify checksums before running a build.

HotRepo's take

HotRepo recorded the repository on the new-project list on 2026-11-15, with 192 stars gained inside a one-hour growth window (16:46–17:46 UTC) and no forks. That is a single snapshot, not a trend. The technical premise — checking region access through a signed-in browser instead of an HTTP probe — is stated with concrete blocked-page signals for AI Studio and Gemini, and the repository layout shows an actual Go engine, shared UI, and desktop/Android shells rather than a wrapper. The unresolved question is distribution: unsigned desktop builds, an Android APK signed with a throwaway key by default, and a parallel Dropbox archive make the binary-to-source correspondence hard to confirm from the materials alone.