git404hub

what is vulture fr?

jendrikseipp/vulture — explained in plain English

Analysis updated 2026-06-26

4,599PythonAudience · developerComplexity · 2/5Setup · easy

tl;dr

A command-line tool that scans Python codebases for dead code, unused functions, classes, variables, and imports, using static analysis with confidence scoring so you know what's safe to delete.

vibe map

mindmap
  root((Vulture))
    What It Does
      Find dead Python code
      Static analysis
      Confidence scoring
    What It Detects
      Unused functions
      Unused classes
      Unused imports
      Unreachable blocks
    Configuration
      pyproject.toml
      Whitelist files
      Exclude paths
    Integration
      pre-commit hook
      CLI tool
    Use Cases
      Codebase cleanup
      Pre-refactor audit

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 make with this?

VIBE 1

Scan a large Python project to find functions, classes, and imports that are never called anywhere.

VIBE 2

Run Vulture as a pre-commit hook so dead code is flagged automatically before every git commit.

VIBE 3

Generate a whitelist file for code Vulture incorrectly flags as unused so future scans stay noise-free.

VIBE 4

Use the --min-confidence flag to focus cleanup work on only the highest-confidence unused code findings.

what's the stack?

Python

how it stacks up fr

jendrikseipp/vulturepromptslab/promptifystvir/pysot
Stars4,5994,6004,600
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencedeveloperdeveloperresearcher

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

how do i run it?

Difficulty · easy time til it works · 5min
No license information was provided in the explanation, check the repository directly.

in plain english

Vulture is a command-line tool for Python developers that scans a codebase and reports code that is never used: unused functions, classes, variables, imports, and unreachable blocks. In a large project that has grown over time, it is common to accumulate old code that nothing calls anymore, and Vulture is designed to surface those leftovers so they can be removed. The tool works through static analysis, meaning it reads the source files without running the program. Because Python is a dynamic language, this approach has limits: code that gets called indirectly (through reflection or dynamic dispatch) may be flagged incorrectly. To handle this, Vulture assigns a confidence percentage to each finding, from 60 percent for things like attributes and class variables up to 100 percent for function arguments and provably unreachable code. Developers can use the --min-confidence flag to focus only on the highest-confidence results. For false positives (code that Vulture flags but actually is used), the recommended approach is to create a whitelist file that lists those items. Vulture can generate this whitelist automatically with the --make-whitelist option. Files or directories can also be excluded entirely, and specific function names or decorator patterns can be ignored with additional flags. Configuration can be stored in a pyproject.toml file under the [tool.vulture] section, which avoids having to repeat flags on every run. Vulture also integrates with pre-commit, so it can run automatically before each git commit to catch dead code early. Installation is via pip. Running it is as simple as pointing Vulture at a Python file or directory. After removing flagged code, running it a second time is recommended, since removing one piece of dead code can reveal others that depended on it.

prompts (copy fr)

prompt 1
I have a large Python Django project and want to find dead code before a refactor. How do I run Vulture on the whole project and interpret the confidence scores?
prompt 2
Show me how to add Vulture to my pre-commit configuration so it automatically flags unused Python code before each commit.
prompt 3
Vulture is flagging a function I know is used through dynamic dispatch. How do I add it to a whitelist so it stops showing up in results?
prompt 4
How do I configure Vulture in pyproject.toml to always ignore my tests directory and only report findings at 80% confidence or higher?

Frequently asked questions

what is vulture fr?

A command-line tool that scans Python codebases for dead code, unused functions, classes, variables, and imports, using static analysis with confidence scoring so you know what's safe to delete.

What language is vulture written in?

Mainly Python. The stack also includes Python.

What license does vulture use?

No license information was provided in the explanation, check the repository directly.

How hard is vulture to set up?

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

Who is vulture for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.