otinstaller · Username

Install Maigret on Linux in one command

Maigret searches a username across thousands of sites and, where it finds a profile, extracts the public fields on it: display name, bio, location, linked accounts. It can write an HTML or PDF report.

Maigret in three lines

pipx install otinstaller
ot install maigret
ot run maigret -- u:jane_doe

Runs soxoj/maigret (MIT, ★ 38k, otinstaller v0.0.4, registry updated Oct 13, 2026). otinstaller installs and runs it; it does not change or verify it.

What Maigret is for

A fuller dossier than Sherlock on one handle.
Finding the same person under a slightly different name through the extracted links.
Reports you can hand to someone who does not read terminals (--html, --pdf).

Typed inputs for Maigret

otinstaller translates these prefixes into Maigret's own flags. Anything else after -- is passed through unchanged, so every original flag still works.

u:: username · ot run maigret -- u:jane_doe

Run every installed tool that takes the same input at once: ot run --all u:jane_doe

Where the results go

Every run lands under ./results/maigret/<target>/ as a timestamped output file plus a .meta.json sidecar: the exact command, start and end time, exit code, and the SHA-256 of the output. Group runs with --case, compare the last two with ot diff maigret <target>, and pull indicators out with ot extract.

Before you run it

The full site list is slow. Use --top-sites for a quick pass.
Some sites need cookies to return profile fields; Maigret still reports the match without them.

Update, remove, inspect

ot info maigret      # inputs, flags, keys
ot example maigret   # sample output
ot update maigret    # move to the next tested version
ot remove maigret    # delete its virtualenv

Full reference for this tool: docs for maigret.

Pairs with

Sherlock

Sherlock checks a username against several hundred sites and reports where a profile with that exact handle exists.

socid-extractor

socid-extractor takes a profile URL and returns the structured fields on the page: user ID, display name, bio, follower counts, linked accounts.

Linkook

Linkook starts from a username, finds profiles, then follows the links those profiles publish to discover further accounts and emails.

When open-source isn't enough

Maigret finds the accounts. SearchIn's identity providers return what is on them and what they connect to, and its leak providers show where the handle appears in breaches.

People & identity

People & identity

Breach intelligence

FAQ

Maigret with otinstaller, answered

How do I install Maigret on Kali or Ubuntu?

Install otinstaller once with pipx install otinstaller, run ot init, then ot install maigret. The tool lands in its own virtualenv under ~/.otinstaller/, pinned to a version that was tested on Ubuntu, so nothing touches your system Python. ot doctor flags a missing git or venv module.

Which inputs does Maigret take through otinstaller?

u: (username). otinstaller maps each prefix to Maigret's own flag. Everything after -- that is not a typed input is passed through unchanged, so the original flags still work.

Where does otinstaller save Maigret results?

Under ./results/maigret/<target>/ in the folder you run from, as a timestamped output file plus a .meta.json sidecar with the exact command, timing, exit code, and SHA-256. Add --case <name> to group runs, and ot diff maigret <target> to compare the last two.

Does Maigret need an API key or a login?

No key is required for the basic run. Optional keys, where the project supports them, go in ~/.otinstaller/.env and are passed only to tools that declare them.

Can I run Maigret together with other tools?

Yes. ot run --all u:jane_doe runs every installed tool that accepts username input, in parallel, including Maigret. Save the combination as a playbook to repeat it.