← Back to Skills Marketplace
samtin0x

GeoInfer Image Geolocation

by samtin0x · GitHub ↗ · v1.0.1
cross-platform ✓ Security Clean
331
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install geoinfer-image-geolocation
Description
AI image geolocation via visual analysis — no GPS or EXIF needed. Requires GEOINFER_API_KEY.
README (SKILL.md)

GeoInfer — AI Image Geolocation

🌍 Geolocate any image using AI — no GPS, no EXIF, no metadata required.

GeoInfer analyzes visual cues (architecture, terrain, vegetation, signage) to predict where a photo was taken, down to city level. Built for OSINT, digital forensics, investigative journalism, and security workflows.

Requires the GEOINFER_API_KEY environment variable.

Setup

  1. Get your API key from app.geoinfer.com/en/api
  2. Run: export GEOINFER_API_KEY="geo_your_key_here"

Tools

Predict Image Location

bash scripts/predict.sh /path/to/image.jpg [model_id] [top_n]
  • model_id — model to use (default: global_v0_1). Run models.sh to list available models.
  • top_n — number of top predictions to return, 1–15 (default: 5)
  • Accepts JPEG, PNG, WebP, and other common image formats (max 10MB)

Example:

bash scripts/predict.sh photo.jpg global_v0_1 5

Output: JSON array of top location predictions with coordinates and confidence scores.

List Available Models

bash scripts/models.sh

Returns all models available to your API key (e.g., Global, Car, Property, Accuracy).

Check Credits

bash scripts/credits.sh

Returns your current credit balance.

Credit Costs

Model type Credits per prediction
Global 1
Car 2
Property 3
Accuracy 3

Agent Usage Notes

  • Always run models.sh first if unsure which model to use
  • Prefer global_v0_1 for general-purpose geolocation
  • Use top_n=1 for fastest single-answer responses; top_n=5 for investigations requiring confidence comparison
  • Check credits before running large batch jobs
  • Images must be local files — download remote images before passing to predict.sh
Usage Guidance
This skill appears internally consistent, but before installing: 1) Understand that any image you run through this will be uploaded to GeoInfer's servers (api.geoinfer.com) — do not upload sensitive or personally identifying images unless you trust the provider and account billing/retention. 2) The scripts use curl and bash; ensure your environment has those binaries. 3) Verify the origin and trustworthiness of the GeoInfer service and the API key you obtain (billing, rate limits, and access scope). 4) Consider using a limited/revocable API key and testing with non-sensitive images first. 5) If you need offline/air-gapped processing or stronger privacy guarantees, this hosted-solution approach may not be suitable.
Capability Analysis
Type: OpenClaw Skill Name: geoinfer-image-geolocation Version: 1.0.1 The skill bundle provides a straightforward interface for an image geolocation API (geoinfer.com). The shell scripts (predict.sh, models.sh, and credits.sh) perform standard API requests using curl, properly handle the required API key via environment variables, and contain no evidence of malicious intent, data exfiltration to unauthorized domains, or obfuscation.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, and included scripts all consistently implement image geolocation and require only GEOINFER_API_KEY. Minor note: the scripts use curl but the registry metadata lists no required binaries; curl (and bash) are implicitly required to run the provided scripts.
Instruction Scope
Runtime instructions and scripts only read a local image file and the declared GEOINFER_API_KEY environment variable, then POST the file to api.geoinfer.com. They do not reference other files, system paths, or unrelated environment variables, nor do they send data to unexpected endpoints.
Install Mechanism
No install spec (instruction-only with small helper scripts). Nothing is downloaded or extracted; files are simple bash scripts that invoke the GeoInfer API.
Credentials
Only a single service-specific credential (GEOINFER_API_KEY) is required, which is appropriate for a hosted API. The scripts do not request additional secrets or unrelated credentials.
Persistence & Privilege
The skill does not request always:true or any special persistence; it will not modify other skills or system-wide settings. Autonomous invocation is allowed by default but is not combined with any elevated privileges here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install geoinfer-image-geolocation
  3. After installation, invoke the skill by name or use /geoinfer-image-geolocation
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added frontmatter metadata for tool name, description, and environment variable requirement. - No changes to functionality or usage instructions. - Existing documentation and usage notes remain unchanged.
v1.0.0
Initial release of GeoInfer — AI Image Geolocation skill: - Allows geolocation of any image based on visual analysis, without GPS or metadata. - Predicts image locations down to the city level using various AI models (supports different model types). - Provides scripts for location prediction, listing available models, and checking credit balance. - Accepts common image formats up to 10MB in size. - Requires a valid GEOINFER_API_KEY for access and usage. - Designed for OSINT, forensics, journalism, and security workflows.
Metadata
Slug geoinfer-image-geolocation
Version 1.0.1
License
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is GeoInfer Image Geolocation?

AI image geolocation via visual analysis — no GPS or EXIF needed. Requires GEOINFER_API_KEY. It is an AI Agent Skill for Claude Code / OpenClaw, with 331 downloads so far.

How do I install GeoInfer Image Geolocation?

Run "/install geoinfer-image-geolocation" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GeoInfer Image Geolocation free?

Yes, GeoInfer Image Geolocation is completely free (open-source). You can download, install and use it at no cost.

Which platforms does GeoInfer Image Geolocation support?

GeoInfer Image Geolocation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GeoInfer Image Geolocation?

It is built and maintained by samtin0x (@samtin0x); the current version is v1.0.1.

💬 Comments