How datalux/osintgram works
Osintgram is a localhost web application for investigating public Instagram data and producing an answer with inspectable results. A user chooses commands directly or asks a question for a local model to select tools; the app runs those lookups through a service layer and a configured Instagram backend, then presents results and optional analysis or exports. The README also describes cost controls, caching, history, dossiers, snapshots, and sharing features. Edges below follow explicit README statements and source-index references; unsampled subsystems are included where documented, with uncertain wiring omitted.
Main entry points: app.py Web application · osint_service.py OSINT service · tools.py Lookup tools · llm_client.py AI mode
Components 22
Web workflow
- Web application
src/web/app.py - Base mode
src/web/app.py - AI mode
src/web/llm_client.py - Lookup tools
src/web/tools.py
OSINT analysis
- OSINT service
src/osint_service.py - Audience audit
src/web/bot_detector.py - Cross-platform scan
src/web/cross_platform.py - Public web search
src/web/web_search.py
Instagram access
- Instagram backend
src/instagrapi_backend.py - HikerAPI
- instagrapi
Results and state
- Cost controls
src/web/cost.py - Request cache
src/web/request_cache.py - Search history
src/web/history.py - HTML dossier
src/web/dossier.py - Media download
src/web/download.py - Graph export
src/web/graph_export.py - Snapshot tracking
src/snapshot_tracker.py - Webhook dispatch
src/webhook_dispatcher.py
Other components
- Local user
- Local model server
- Webhook destinations
Connections 23
- Local user → Web application: submits query
README.md - Web application → Base mode: offers mode
README.md - Web application → AI mode: offers mode
README.md - AI mode → Local model server: requests tool calls
README.md - Web application → Lookup tools: builds tools
src/web/app.py - AI mode → Lookup tools: selects tools
README.md - Base mode → Lookup tools: runs selections
README.md - Lookup tools → OSINT service: calls lookups
src/web/tools.py - OSINT service → Instagram backend: calls backend
src/osint_service.py - Instagram backend → instagrapi: adapts client
src/instagrapi_backend.py - OSINT service → Audience audit: audits followers
src/osint_service.py - OSINT service → Cross-platform scan: scans usernames
src/osint_service.py - Lookup tools → Public web search: searches public web
src/web/tools.py - OSINT service → HikerAPI: fetches Instagram data
- Web application → Cost controls: estimates cost
src/web/app.py - Web application → Request cache: uses cache
src/web/app.py - Web application → Search history: uses history
src/web/app.py - Web application → HTML dossier: creates report
src/web/app.py - Web application → Media download: serves downloads
src/web/app.py - Web application → Graph export: exports graph
src/web/app.py - Web application → Snapshot tracking: tracks snapshots
src/web/app.py - Web application → Webhook dispatch: dispatches changes
src/web/app.py - Webhook dispatch → Webhook destinations: sends notifications