Cupp Save

Common User Passwords Profiler (CUPP)

Project README

CUPP - Common User Passwords Profiler

Build Status Coverage Status Codacy Badge Rawsec's CyberSecurity Inventory


The most common form of authentication is the combination of a username and a password or passphrase. If both match values stored within a locally stored table, the user is authenticated for a connection. Password strength is a measure of the difficulty involved in guessing or breaking the password through cryptographic techniques or library-based automated testing of alternate values.

A weak password might be very short or only use alphanumberic characters, making decryption simple. A weak password can also be one that is easily guessed by someone profiling the user, such as a birthday, nickname, address, name of a pet or relative, or a common word such as God, love, money or password.

That is why CUPP was born, and it can be used in situations like legal penetration tests or forensic crime investigations.


You need Python 3 to run CUPP.

Quick start

$ python3 -h


Usage: [OPTIONS]

    -h      this menu

    -i      Interactive questions for user password profiling

    -w      Use this option to profile existing dictionary,
            or output to make some pwnsauce :)

    -l      Download huge wordlists from repository

    -a      Parse default usernames and passwords directly from Alecto DB.
            Project Alecto uses purified databases of Phenoelit and CIRT which where merged and enhanced.

    -v      Version of the program


CUPP has configuration file cupp.cfg with instructions.

Example (Fast forwarded)



This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

See './LICENSE' for more information.

Github import

This project was imported into by Mebus from:
to encourage further development of the tool.

Original author

Muris Kurgas aka j0rgan
[email protected]


Open Source Agenda is not affiliated with "Cupp" Project. README Source: Mebus/cupp
Open Issues
Last Commit
3 months ago

Open Source Agenda Badge

Open Source Agenda Rating