explaingit

soxoj/maigret

Analysis updated 2026-06-21

25,895PythonAudience · researcherComplexity · 2/5LicenseSetup · easy

TLDR

Give Maigret a username and it searches 3,000+ websites to find where that person exists online, then compiles the results into a report with profile links, photos, and connections.

Mindmap

mindmap
  root((Maigret))
    What it does
      Username search
      3000+ site checks
      Profile aggregation
    Output Formats
      PDF report
      HTML report
      Interactive graph
    Key Features
      Cross-profile linking
      AI summary mode
      Telegram bot
    Audience
      Investigators
      Journalists
      Security researchers
Click or tap to explore — scroll the page freely

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 a username to find all social media accounts, forums, and communities linked to that person across 3,000+ sites.

USE CASE 2

Build a connected map of someone's online presence by following links between discovered profiles to find additional usernames.

USE CASE 3

Export a background research report as PDF, HTML, or an interactive graph showing an account's network.

USE CASE 4

Embed Maigret as a Python library inside a people-search or background-check product.

What is it built with?

PythonaiohttpJinja2networkx

How does it compare?

soxoj/maigretwalter201230/pythonycm-core/youcompleteme
Stars25,89525,88225,910
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity2/51/54/5
Audienceresearchervibe coderdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

pip install maigret, no API keys needed for basic use, commercial use requires a separate license.

Free for personal and research use, commercial use requires a separate license from the authors.

In plain English

Maigret is an open-source OSINT (Open Source Intelligence) tool that searches for a person across the internet using just their username. You give it a single username, and it checks over 3,000 websites, social networks, forums, photo platforms, dating sites, coding communities, to see if that username exists anywhere, then compiles everything it finds into a report. The tool is aimed at investigators, security researchers, journalists, and anyone doing background research on a person. It goes beyond a simple username check by also extracting profile information from found accounts, following links between profiles to find additional usernames, and building a connected map of a person's online presence. Reports can be exported as PDF, HTML, interactive graphs, or spreadsheets. For practical use: type in a username you found on one platform, and Maigret tells you where else that person appears online, often revealing real names, locations, profile photos, and connections between accounts. An optional AI analysis mode can summarize the findings in plain English. There is also a Telegram bot if you do not want to install anything. Built in Python and free to use, it requires no API keys for basic operation. Commercial use requires a separate license. It is used by professional social media intelligence platforms as a core engine. For a founder or vibe coder: this is a ready-to-run investigation tool, not a building block. If you are building a people-search or background-check product, you could embed it as a Python library, but most users just run it directly from the command line.

Copy-paste prompts

Prompt 1
Run Maigret on the username 'john_doe' and export the results as an HTML report, show me the exact command and what the output looks like.
Prompt 2
How do I install Maigret and run my first username search from the command line, without any API keys?
Prompt 3
After Maigret finds accounts on 30 sites, how do I use the --follow-redirects or graph output to discover additional usernames linked from those profiles?
Prompt 4
How do I use the Maigret Telegram bot to look up a username without installing anything locally?
Prompt 5
Can I import Maigret as a Python library in my own script and call the search programmatically instead of using the CLI?

Frequently asked questions

What is maigret?

Give Maigret a username and it searches 3,000+ websites to find where that person exists online, then compiles the results into a report with profile links, photos, and connections.

What language is maigret written in?

Mainly Python. The stack also includes Python, aiohttp, Jinja2.

What license does maigret use?

Free for personal and research use, commercial use requires a separate license from the authors.

How hard is maigret to set up?

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

Who is maigret for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub soxoj on gitmyhub

Verify against the repo before relying on details.