Repo brief: soxoj/maigret

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T05:33:00.270Z · commit 578d603e8f1d

Verdict

Healthy — Healthy across all four use cases

• Last commit today
• 14 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Maigret is a Python-based OSINT (Open Source Intelligence) tool that collects comprehensive dossiers on individuals by searching their usernames across 3000+ websites simultaneously, returning all discovered accounts and associated metadata without requiring API keys. It combines web scraping, error detection heuristics, and optional AI profiling to aggregate publicly available information from a massive federated site database stored in maigret/resources/data.json. Monolithic Python package structure: core logic lives in maigret/ with checking.py (site verification), sites.py (site registry), and maigret.py (orchestration); web UI in maigret/web/ (Flask-based with Jinja2 templates in…

Start here

Open these first:

• maigret/maigret.py — Main orchestrator for username searches across sites; core entry point for search logic and result aggregation.
• maigret/resources/data.json — Database of 3000+ sites with their checking endpoints, patterns, and metadata; essential lookup table for all searches.
• maigret/checking.py — HTTP request execution and site availability detection; implements the core site-checking algorithm.
• maigret/sites.py — Site abstraction layer that parses data.json and exposes site configuration for checks.
• maigret/web/app.py — Flask web server and API endpoints; provides interactive and programmatic access to search functionality.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone and install using poetry (recognized in poetry.lock and pyproject.toml): git clone https://github.com/soxoj/maigret.git && cd maigret && poetry install. Verify Python 3.10+ is available. For standalone binary, con…

Daily commands:

CLI: python -m maigret <username>. Web UI: inferred from maigret/web/app.py structure, likely poetry run maigret-web or similar (exact command not visible in provided data; verify pyproject.toml). Docker: docker build -…

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 55% of recent commits
• Non-obvious constraints: (1) pefile==2023.2.7 is version-pinned due to pyinstaller 6.11.1 incompatibility — upgrading either will break binary packaging; (2) data.json is external-dependent and will degrade as target…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.