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 actually work for accessing Google AI Studio and Gemini. It tests each config the way a person would: in a signed-in browser, through the route you will really use. Version 0.1.0 is an early pre-release. It works end to end on Windows (the only platform it has been run on so far). The macOS, Linux and Android builds come from the CI pipeline and have not been exercised on real devices yet.

Key features

  • Two modes: Simple (tests your configs directly) and Advanced (chains free configs behind a base config).
  • Anti-DPI profile applied to every config under test (Simple) or to the base config's first hop (Advanced).
  • Region check via a signed-in browser: opens AI Studio and Gemini as you, detecting block pages.
  • Supports config types: vless://, vmess://, trojan://, ss://, subscription URLs, and base64 text.
  • Export options: links, base64, a full Xray config (Simple) or a chain Xray config (Advanced).
  • Available on Windows, macOS, Linux, Android (connectivity-only mode), and as a web server for any OS.
  • Remembers settings on device when “remember” is ticked.

Use cases

  • Simple mode: check a pile of configs you already have; test a config before you rely on it.
  • Advanced mode: your Cloudflare config works but you need a different exit that Google accepts; find free configs that work through your config.
  • Use the connectivity-only mode on Android (no signed-in browser available).

Getting started

Download the build for your system from the Releases page. Every release ships SHA256SUMS.txt. Windows: 1. Download gemini-config-checker-desktop__windows_amd64.zip (or arm64) and unzip it anywhere. 2. Run GeminiConfigChecker.exe. macOS: 1. Download ..._macos_universal.zip, unzip, and move the .app to Applications. 2. First launch: right-click the app → Open. If macOS still refuses: xattr -dr com.apple.quarantine '/Applications/GeminiConfigChecker.app' Linux: 1. sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 (Debian/Ubuntu; use your distribution's equivalents). 2. tar -xzf gemini-config-checker-desktop__linux_amd64.tar.gz, then run ./GeminiConfigChecker. Android: 1. Download gemini-config-checker__android_arm64.apk on the phone. 2. Allow Install unknown apps for your browser or file manager, then open the APK. Web server (any OS): ./gemini-config-checker serves the same UI on http://localhost:8787 and opens your browser. Flags: -addr 127.0.0.1:8787, -no-open, -version. After starting, click Sign in with Google to perform the region check.

License and pricing

Licensed under Apache-2.0. Open source and free.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/weldbladesmithwharfgemini-config-checker.svg)](https://yunodb.com/tools/weldbladesmithwharfgemini-config-checker?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/weldbladesmithwharfgemini-config-checker?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/weldbladesmithwharfgemini-config-checker.svg" alt="Featured on YunoDB" height="20"></a>