VolumePhoenixDeem/Gemini-Config-Checker-

Gemini Config Checker

Gemini Config Checker tests proxy configurations by opening Google AI Studio and Gemini in a signed-in browser, then reading whether Google shows the region wall. Plain HTTP probes report every live proxy as healthy because Google decides availability per signed-in account after page load, so the tool uses an actual browser session as the signal.

It supports two modes. Simple tests a list of configs you already have, or a ready-made free list, and reports which ones pass. Advanced chains free configs behind a working base config to find a different exit Google accepts. Supported input formats include vless://, vmess://, trojan://, ss://, subscription URLs and base64 text.

It is aimed at users troubleshooting which of their existing proxy configs can actually reach Gemini and AI Studio, not at general network diagnostics.

Quick Start

1. Download the build for your system from the Releases page. Desktop builds exist for Windows amd64/arm64, macOS universal and Linux amd64; the Android APK is arm64-v8a only.
2. On Linux, install the WebKit runtime first: sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 (or use the web server build and open http://localhost:8787).
3. Launch the app and keep the default Simple mode. Paste one config per line into the box, or leave it empty to scan a built-in free list.
4. Click Sign in with Google. A separate Chrome/Edge/Brave profile opens; sign in there and the window closes when detected.
5. Press Start scan and read the Results tab. Region mode takes roughly 20–40 s per config; use connectivity only when you just need to know a route reaches Google.

Build alternatives from source are documented in the build section: make web, make desktop, make android, and make dist VERSION=0.1.0.

Constraints

• Region checking requires Chrome, Edge or Brave; Flatpak browsers cannot be driven. If no compatible browser is present, switch to connectivity-only mode, which does not verify region.
• Desktop builds are unsigned: Windows may show SmartScreen, and macOS may need a right-click Open or a quarantine removal step.
• The tool has only been exercised end to end on Windows; macOS, Linux and Android builds come from CI and have not been tested on real devices.
• Android cannot drive a signed-in Chromium, so only connectivity mode works there.
• Free configs are run by unknown operators; the README advises against sending sensitive traffic through them.
• The web server has no authentication and must stay bound to localhost or be reached through an SSH tunnel.
• The project declares MIT in its LICENSE file while the repository metadata lists Apache-2.0.

HotRepo's take

The repository arrived on the new-project list on 2026-11-15 with 192 stars in its first observed window and no forks, which is a sharp early spike but only a single snapshot — too little to judge sustained interest. The most useful thing for readers is the design choice: reading Google's own region page in a signed-in browser instead of relying on latency or HTTP status, which matches the per-account region behavior the README describes.