---
title: GeoBot
emoji: 🌍
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# GeoBot

A tiny, fully self-hosted AI opponent for a GeoGuessr-style game. It receives two
Street View images (headings ~0° and ~180°) and returns a country guess with a
coordinate and human-readable reasoning.

It does **no training and no external AI calls**. It embeds the two images with
CLIP (`openai/clip-vit-base-patch32`, vision tower only, CPU) and retrieves the
nearest examples from a precomputed index of visual geography clues, votes on a
country, and fills reasoning templates from the matched clue labels.

- `POST /guess` — multipart `image0`, `image180`; header `X-API-Key`.
- `GET /health` — liveness + index size (also the wake-up ping target).

Geographic clue knowledge derived from the community guides at
[plonkit.net](https://plonkit.net) (embeddings only; no images redistributed).