WhereGo

WhereGo

🚀 The fastest open-source IP geolocation API built with Go and Fiber.

Features

• ⚡ Ultra-fast - Zero-allocation hot path, ~500ns per lookup
• 🔄 Prefork mode - Utilizes all CPU cores
• 🐳 Docker ready - Multi-arch images (amd64/arm64)
• 📦 Tiny image - ~20MB distroless container
• 🛡️ Production ready - Health checks, graceful shutdown

Quick Start

Docker

docker run -p 8080:8080 gustavosett/wherego:latest

From Source

git clone https://github.com/gustavosett/WhereGo.git
cd WhereGo
go run ./cmd/api

API Endpoints

Lookup IP

curl http://localhost:8080/lookup/8.8.8.8

Response:

{
  "ip": "8.8.8.8",
  "country": "United States",
  "city": "Mountain View",
  "iso_code": "US",
  "timezone": "America/Los_Angeles"
}

Health Check

curl http://localhost:8080/health

Response:

{"status":"ok"}

Performance

Benchmarks on AMD Ryzen 9 5900X:

Configuration

License

MIT License - see LICENSE for details.