Gemini-Config-Checker-
Chain region scanner: find proxy configs that get you into Google AI Studio and Gemini (signed-in browser check, anti-DPI, Windows/macOS/Linux/Android)
What is Gemini-Config-Checker-?
Chain region scanner: find proxy configs that get you into Google AI Studio and Gemini (signed-in browser check, anti-DPI, Windows/macOS/Linux/Android)
Overview of Gemini-Config-Checker-
What it is
Gemini Config Checker is a tool that finds proxy configurations which allow access to Google AI Studio and Gemini. It tests each configuration by simulating a signed-in browser session through the actual route a user would take. The tool is in early pre-release (version 0.1.0) and has been tested end-to-end on Windows. Builds for macOS, Linux, and Android are provided via CI but have not been exercised on real devices. It offers two modes: Simple and Advanced.
Key features
- Two modes: Simple mode tests user-provided configurations directly; Advanced mode chains a base configuration with free configurations to find working exits.
- Signed-in browser region check: Opens AI Studio and Gemini in a separate Chrome/Edge/Brave profile to detect region blocks based on the signed-in account.
- Anti-DPI profile applied to configurations under test (Simple mode) or to the base config's first hop (Advanced mode).
- Export options: links, base64, full Xray config (Simple) or chain Xray config (Advanced).
- Supports multiple config formats: vless://, vmess://, trojan://, ss://, subscription URLs, and base64 text.
- Cross-platform: Windows, macOS, Linux, Android, and a web server build for any OS.
- Connectivity-only mode for Android (no signed-in browser check).
Use cases
- Determine which of your existing proxy configurations work for accessing Google AI Studio and Gemini.
- Verify a specific configuration before relying on it.
- When a Cloudflare-based configuration connects but Google blocks its exit, use Advanced mode to chain free configurations behind it to find an acceptable exit.
- Scan a list of free configurations to find those that work through a base configuration.
Getting started
Download the appropriate build for your system from the Releases page. Each release includes SHA256SUMS.txt. For Linux (Debian/Ubuntu), install runtime libraries and run: sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 tar -xzf gemini-config-checker-desktop__linux_amd64.tar.gz ./GeminiConfigChecker For the web server build (any OS): ./gemini-config-checker Then open http://localhost:8787 in a browser. For Windows, download the zip, unzip, and run GeminiConfigChecker.exe. For macOS, download the universal zip, unzip, move the .app to Applications, and right-click to open. For Android, download the APK and install.
License and pricing
The project is open source under the Apache-2.0 license. No pricing information is stated.
Based on the project's public README and repository metadata.