whatisgithub

What is osint-terminal?

rojansapkota/osint-terminal — explained in plain English

Analysis updated 2026-05-18

29PythonAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A self-hosted dashboard with 438 free lookup tools for researching IPs, domains, emails, and more, meant for authorized security research and education.

Mindmap

mindmap
  root((OSINT Terminal))
    What it does
      Keyless lookups
      3D threat globe
      Case tracking
    Tech stack
      Python
      JavaScript
      Docker
    Use cases
      Security research
      Domain investigation
      Threat intel
    Audience
      Developers
      Security researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Look up public information about an IP, domain, or email during authorized security research.

USE CASE 2

Group related findings into a named case while investigating a target.

USE CASE 3

View a live 3D globe of public threat and geo data feeds.

USE CASE 4

Run the same lookup across many targets at once with the batch API.

What is it built with?

PythonJavaScriptDocker

How does it compare?

rojansapkota/osint-terminaladityasharmadotai-hash/docs-reader-rag-agentalekseiul/hermes-researcher-agent
Stars292929
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencedevelopervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

No API keys needed, optional packages add image and phone-number features.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

OSINT Terminal is a self-hosted dashboard for open-source intelligence research, meaning it helps someone look up publicly available information about an IP address, domain, email, phone number, or other identifier without needing any paid API keys or accounts. The README is explicit that it is meant for authorized security research, education, and defensive investigation, and warns users to have permission before looking into any target. The project ships with 438 individual lookup tools, grouped into categories such as network and IP information, domain and website details, email security posture, identity and username searches, phone number parsing, image metadata, cryptocurrency address lookups, threat intelligence feeds, academic paper search, geographic tools, and text encoding and decoding utilities. A notable feature is an interactive 3D globe that shows live data overlays, including earthquakes, aircraft positions, known malware command and control servers, and the location of the International Space Station. Everything runs locally: results, search history, favorites, and saved investigation cases are stored as plain JSON files on the user's own machine, and nothing is sent elsewhere except the actual lookups the user runs. The backend is written using only Python's built in web server library plus the requests package, with a plain JavaScript frontend and no separate build step required. To get started, a user clones the repository, installs the Python dependencies, and runs a single server script, then opens a web page in their browser. It also runs in Docker if preferred. The tool exposes a JSON API so results, running single lookups, running many lookups at once, and managing saved cases can all be done through simple web requests as well as the browser interface. Two optional dependencies add extra features like reading image location data or parsing phone numbers in more detail, and tools missing those dependencies simply return an explanatory message instead of failing.

Copy-paste prompts

Prompt 1
Explain how the batch query API in osint-terminal works.
Prompt 2
Walk me through running this dashboard locally with Docker.
Prompt 3
Show me how the tool registry in osint.py is structured so I can add a new lookup tool.
Prompt 4
How does the local case-saving feature keep my investigation data on my own machine?

Frequently asked questions

What is osint-terminal?

A self-hosted dashboard with 438 free lookup tools for researching IPs, domains, emails, and more, meant for authorized security research and education.

What language is osint-terminal written in?

Mainly Python. The stack also includes Python, JavaScript, Docker.

What license does osint-terminal use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is osint-terminal to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is osint-terminal for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.