visionguruoutfit/Gemini-Config-Checker-

What it does

Gemini Config Checker is a desktop, web and Android tool for checking which proxy configurations actually reach Google AI Studio and Gemini. Rather than sending a plain HTTP probe, it opens AI Studio and Gemini in a browser profile that is signed in as the user and reads Google's own region verdict: AI Studio redirects to its available-regions page, and Gemini reports that the country is unsupported. The README argues this is necessary because a plain request can report success from a blocked region.

The app runs the Xray-core proxy engine and supports vless://, vmess://, trojan:// and ss:// links, subscription URLs, base64 lists and full Xray JSON configs. Two modes differ in routing: Simple tests each config directly, while Advanced chains free configs behind one working base config to obtain a different exit. An optional anti-DPI profile reproduces a published fragmentation recipe for networks where plain Cloudflare configs do not connect.

It is aimed at users who already operate proxy clients and need to know whether a given route works for Gemini, especially in filtered networks.

Quick start

1. Download the build for your platform from the Releases page. Every release includes SHA256SUMS.txt.
2. On Windows, unzip the package and run GeminiConfigChecker.exe; the build is unsigned, so SmartScreen may require More info → Run anyway. macOS needs a right-click → Open on first launch. Linux requires libgtk-3-0 and libwebkit2gtk-4.1-0.
3. Open the Scan tab. For Simple mode, paste configs one per line, or leave the box empty to use a ready-made free list.
4. Click Sign in with Google. A Chrome, Edge or Brave window opens in a separate profile; after sign-in is detected the window closes and the card shows the account as connected.
5. Press Start scan and watch the Results tab. Region mode takes roughly 20–40 seconds per config; connectivity-only mode is faster but does not verify the region.
6. In the Export tab, copy share links, a base64 subscription, or a ready-to-import Xray config.

If you have no supported browser, or are on Android, switch the check type to connectivity only in Settings.

Constraints

• Region checking needs a locally installed Chrome, Edge, Brave or Chromium; Flatpak browsers cannot be driven. Android supports connectivity-only checks, so the region is not verified there.
• The README states only the Windows build has been exercised end to end; macOS, Linux and Android builds come from CI and have not been run on real devices.
• A result is a sample: Cloudflare Worker exits can change between connections, so a config may pass and later fail. Re-test before relying on one.
• Free configs are operated by unknown third parties; the project advises against sending sensitive traffic through them.
• The web-server build has no authentication and is intended for localhost or an SSH tunnel only.
• The license is stated as MIT, while the bundled Xray-core and fonts carry their own licenses.
• The README top banner links to an RAR archive on Dropbox, separate from the Releases download path; use the Releases page instead of that link.

HotRepo's take

The repository appeared on HotRepo's new-project list on 2026-11-15, gaining 192 stars in about an hour of recorded growth. That is a very early snapshot for a project whose README labels itself a 0.1.0 pre-release and admits only one platform has been run end to end. The contrast between rapid early attention and the stated platform coverage is the main thing to weigh: treat the macOS, Linux and Android builds as untested per the project's own note, and prefer the checksummed release artifacts over the Dropbox archive in the banner.