# Mebus/cupp

Common User Passwords Profiler (CUPP)

Repository: https://github.com/Mebus/cupp
Canonical: https://ross.abutalabs.com/products/cupp
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: wordlist-generator, wordlist, dictionary-attack, password, password-strength, weak-passwords
Last push: 2026-07-17T23:57:44+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 35, longevity 100
- inputs: {"age_days": 5232, "days_push": 47, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6507, forks 2381 (observed 2026-08-28T04:09:43.933532+00:00)

## What it is
CUPP is a Python CLI tool that generates targeted password wordlists by profiling personal information about a user, such as birthdays, nicknames, and pet names. It is intended for legal penetration testing and forensic investigations, and can also enhance existing dictionaries or download large wordlists.

## Use cases
- generate a custom password wordlist for a penetration test
- create targeted password guesses from personal details about a target
- enhance an existing dictionary with profiled password variations
- download large password wordlists for dictionary attacks
- test password strength against socially engineered guesses
- parse default usernames and passwords from the Alecto database

## When to choose
- you need targeted, personalized password wordlists based on known information about a person
- you are conducting an authorized penetration test or forensic investigation
- you want a simple interactive Python tool with no heavy dependencies
- you want to augment an existing wordlist or WyD.pl output

## When to avoid
- you need general-purpose large wordlists rather than targeted profiles
- you require GPU-accelerated password cracking itself - CUPP only generates lists, it does not crack hashes
- you need a GUI-based tool
- your use case is not an authorized security assessment

## Facets
- artifact type: cli-tool
- maturity: active
- function: security, penetration-testing, cli, data-generation
- domain: security, penetration-testing
- platform: python, cli, windows, cross-platform
- tags: wordlist-generator, password-profiling, dictionary-attack, password-cracking, osint, command-line, linux, macos

## Member repositories
- Mebus/cupp (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:43.933532+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:44:27.661515+00:00, confidence not recorded.
  - readme: https://github.com/Mebus/cupp (fetched 2026-08-28T04:09:43.933532+00:00, sha 4c1425ab638a)
- Data as of 2026-08-30T08:39:29.467469+00:00.