YellowLaborerMarket/Gemini-Config-Checker-
Productivity & UtilitiesTests proxy configs in a signed-in browser to see which ones reach Google AI Studio and Gemini.
What it does
Gemini Config Checker scans a list of proxy configs and reports which ones can actually reach Google AI Studio and Gemini. Google decides regional availability per signed-in account after the page loads, so a plain HTTP probe is misleading; the tool opens AI Studio and Gemini in a dedicated browser profile signed in as you and reads the result (a redirect to the available-regions page, or the "not supported in your country" message) Why a signed-in browser.
It has two modes. Simple tests each config directly; Advanced chains free configs behind one working base config to find an exit Google accepts. An optional anti-DPI profile fragments the TLS ClientHello for use on filtered networks Anti-DPI profile. It is aimed at people who already hold proxy configs and need to know which ones work before relying on them.
Quick start
- Download the build for your platform from the Releases page and check it against the shipped
SHA256SUMS.txtDownload and install. Windows users unzip and runGeminiConfigChecker.exe; Linux needslibgtk-3-0andlibwebkit2gtk-4.1-0. - Launch the app. In the Scan tab choose Simple, paste
vless://,vmess://,trojan://orss://links one per line (or leave the box empty to test a built-in free list). - Click Sign in with Google and complete sign-in in the separate browser window that opens. A secondary account is recommended.
- Press Start scan and watch the Results tab. Region mode takes roughly 20–40 s per config because it drives a real browser Settings reference.
- Copy a passing config as a share link, or use Copy with chain / Copy full config to get an importable Xray JSON.
The full walkthrough, including Advanced mode and export targets, is in the user guide.
Constraints and limits
- Version 0.1.0 is a pre-release exercised only on Windows; macOS, Linux and Android builds come from CI and have not been run on real devices.
- Region checking needs Chrome, Edge, Brave or Chromium. Android and connectivity-only mode can prove reachability and latency but cannot verify the region.
- Builds are unsigned. SmartScreen and Gatekeeper will warn; the README explains how to bypass them.
- A verdict is a sample: a Cloudflare Worker exit can change between connections, so re-test a config before keeping it. Only
fragmentmasks of the anti-DPI recipe are supported. - The web server build has no authentication; keep it bound to localhost or tunnel it.
- The repository declares the MIT license, while the bundled Xray-core and fonts keep their own licenses (MPL-2.0, SIL OFL) LICENSE.
- Free configs are operated by unknown third parties; do not send sensitive traffic through them.
HotRepo's take
HotRepo recorded the project in its new-repository list on 2026-11-15, with 256 stars gained from about 1.5 hours of observation and no forks. That is a very short window, so it shows initial attention only, not adoption or quality. The subject matter fits: region-restricted Gemini access and free-config scanning are widely shared concerns, and the README does describe a concrete mechanism (signed-in browser check plus a local fragmenting forwarder). The main thing to watch is distribution: the README's most prominent download button points to an external file-sharing archive, while the install section describes signing and SHA256 checksums via releases. Readers should confirm what they run against the published checksums.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- WerewolfEmuHub/Gemini-Config-Checker-Tests proxy configs in a signed-in browser to see which ones reach Google AI Studio and Gemini.
- VisionWormStudio/Gemini-Config-Checker-Scans proxy configs to find ones that actually reach Google AI Studio and Gemini for a signed-in user.
- Updatedelcure/Gemini-Config-Checker-Tests proxy configs for whether a signed-in Google account can reach AI Studio and Gemini.
- TrooperFilter/Gemini-Config-Checker-Scan proxy configs in a signed-in browser to find routes that 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.