Osintgram

# Osintgram 🔎📸

[![version](https://img.shields.io/badge/version-2.0-green)](doc/CHANGELOG.md)
[![GPLv3](https://img.shields.io/badge/license-GPLv3-blue)](LICENSE)
[![Python3](https://img.shields.io/badge/python-3.10%2B-red)](https://www.python.org/)
[![tests](https://github.com/Datalux/Osintgram/actions/workflows/tests.yml/badge.svg)](.github/workflows/tests.yml)
[![local-first](https://img.shields.io/badge/runs-100%25%20locally-8b5cf6)](#quick-start)

**Point it at an Instagram account and find out who's behind it.** Osintgram
collects, cross-references and lays out everything a public profile gives away
— followers, captions, hashtags, geotagged locations, posting habits, public
contact details — in a web interface you run on your own machine.

Ask in plain language and a **local AI model** figures out which lookups to
run. Or don't: pick the commands yourself and skip the model entirely.

<p align="center">
<img src=".img/web-app.png" width="900" alt="The Osintgram web interface: the request form with a run sheet showing limits and cost, the written answer, and numbered result exhibits with profile details and hashtags">
</p>

---

## Why you might like it

**It answers questions, not just commands.** *"How many followers do they have and which
hashtags do they use most?"* runs three lookups and comes back with a written answer —
and the raw results underneath, so you can check the work instead of trusting
the prose.

**Nothing leaves your machine except the lookups themselves.** The AI runs
locally through [Ollama](https://ollama.com): no OpenAI key, no subscription, no
prompt of yours sent to anyone. The interface is served from `127.0.0.1`.

**It tells you what a search will cost before you run it.** Instagram data
isn't free, and most tools let you find out the expensive way. This one prices
your selection up front, shows your remaining credit, caches every request so
you never pay twice for the same lookup, and lets you cap or stop a run —
server-side, not just in the browser.

**It shows you what it found, properly.** Post thumbnails in a filterable grid,
geotagged locations on a map, a weekday × hour heatmap of when someone posts,
comparison between two accounts. Not a wall of JSON — though the JSON is one
click away on every card.

**You can hand the result to someone else.** One button turns a finished search
into a standalone HTML report that opens in any browser, with no server and no
Osintgram.

---

## Two ways to drive it

<p align="center">
<img src=".img/web-commands.png" width="860" alt="Base mode: 28 commands in two columns, grouped by colour and collapsible, with a search box and the run sheet">
</p>

**AI mode** — describe what you want. A local model picks the commands, runs
them and summarizes. It can only choose from the same list below; it can't
invent lookups or make up data.

**Base mode** — no model, no Ollama needed. All 29 commands, one line each,
grouped and searchable. Tick what you want, set the parameters, run