RepoPilot

sherlock-project/sherlock

Hunt down social media accounts by username across social networks

Healthy

Healthy across all four use cases

HealthyDependency

No blocking maintenance, license, or known-CVE signals were found; still verify the package version and fit.

HealthyFork & modify

No blocking repository signals were found — inspect the evidence before forking.

HealthyLearn from

Documented and popular — useful reference codebase to read through.

HealthyDeploy as-is

No blocking repository-level signals were found; deployment review is still required.

  • ⚠Scorecard: marked unmaintained (2/10)
  • ✓Last commit 1d ago
  • ✓24+ active contributors
  • ✓Distributed ownership (top contributor 31% of recent commits)
  • ✓MIT licensed
  • ✓CI configured
  • ✓Tests present

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

Informational only. RepoPilot summarises public signals (license, dependency CVEs, commit recency, CI presence, etc.) at the time of analysis. Signals can be incomplete or stale. Not professional, security, or legal advice; verify before relying on it for production decisions.

Repository brief

Repo brief: sherlock-project/sherlock

Generated by RepoPilot · document generated 2026-09-15 · concise human review Evidence snapshot · analyzed 2026-09-15T01:34:37.335Z · commit 9100f9d40a32

Verdict

Healthy — Healthy across all four use cases

  • Last commit 1d ago
  • 24+ active contributors
  • Distributed ownership (top contributor 31% of recent commits)
  • MIT licensed
  • 2 more receipts 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

Sherlock is a Python-based OSINT (Open Source Intelligence) tool that searches for usernames across 400+ social networks and returns accounts found in text/CSV/Excel/JSON formats. It automates the tedious process of checking if a username exists on multiple platforms by making concurrent HTTP requests and parsing site-specific response patterns. Single-package structure under sherlock_project/ with a modular design: sherlock.py contains core search logic, sites.py manages site definitions loaded from resources/data.json (validated against data.schema.json), result.py handles result storage, and notify.py manages notifications. CLI entry point via __main__.py. Tests under…

Start here

Read these in order:

  • sherlock_project/__init__.py — Foundation: doesn't import anything internally and is imported by 5 other files. Read first to learn the vocabulary.
  • sherlock_project/result.py — Foundation: imported by 4, no internal dependencies of its own.
  • sherlock_project/notify.py — Built on the foundation; imported by 3 downstream files.
  • sherlock_project/__main__.py — Built on the foundation; imported by 0 downstream files.
  • sherlock_project/sherlock.py — Layer 2 — application-level code that wires the lower layers together.

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 the repository, then install via one of the three verified methods shown in the README: pipx install sherlock-project (recommended), docker run -it --rm sherlock/sherlock, or system package managers. The `pypr…

Daily commands:

For CLI usage: sherlock <username> or sherlock <user1> <user2> .... For development, first verify pyproject.toml for test command (pytest is configured via pytest.ini). Run pytest from repository root. See `to…

…shortened for this brief.

Key cautions & unknowns

  • Scorecard: marked unmaintained (2/10)
  • Site definitions in data.json can become stale quickly—sites change HTML structure, add rate-limiting, or require authentication, causing false negatives. The --ignore-exclusions flag and exclusions workflow…
  • Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

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.

Save as

Full context for agent files, or a concise PDF for human review.

View complete agent reference

Open to load every section of the agent reference.

Want this for your own repo?

Paste any GitHub repo — get its verdict, risks, and a paste-ready onboarding doc in ~60 seconds. Free, no sign-up.

Embed the "Healthy" badge

Paste into your README — live-updates from the latest cached analysis.

Variant:
RepoPilot: Healthy
[![RepoPilot: Healthy](https://repopilot.app/api/badge/sherlock-project/sherlock)](https://repopilot.app/r/sherlock-project/sherlock)

Paste at the top of your README.md — renders inline like a shields.io badge.

▸Preview social card

This card auto-renders when someone shares https://repopilot.app/r/sherlock-project/sherlock on X, Slack, or LinkedIn.

Ask AI about sherlock-project/sherlock

Grounded in the actual source code. Pick a starter question or write your own.

What does this repo do, in one paragraph?How would I get started using it?What are the main alternatives?Show me the entry point.
Or write your own question

Similar Python repos

Other healthy-signal Python repos by stars.

Embed this chat in your README

Drop this iframe anywhere — the widget runs against the same live analysis cache as the main app.

<iframe
  src="https://repopilot.app/embed/sherlock-project/sherlock"
  width="100%" height="500"
  style="border:1px solid #d0d7de; border-radius:8px;"
  allow="microphone"
  loading="lazy"
></iframe>