Repository files navigation

Mentalist is a graphical tool for custom wordlist generation. It utilizes common human paradigms for constructing passwords and can output the full wordlist as well as rules compatible withHashcat andJohn the Ripper.

For more information on installing and using Mentalist, pleasevisit the wiki.

Prebuilt executables are available forv1.0 (Python 3.6-3.10 only). For v2.0+ with Python 3.11+ support, use Poetry or pip installation below.

IMPORTANT: Version 2.0+ requires Python 3.11 or higher. If you need to use an older Python version, please useMentalist v1.0.

Mentalist requirestkinter (Python's standard GUI library). While tkinter is included with Python, the underlying Tcl/Tk libraries may need to be installed separately depending on your system.

macOS (Homebrew Python):

# Install python-tk matching your Python versionbrew install python-tk@3.13# For Python 3.13brew install python-tk@3.12# For Python 3.12brew install python-tk@3.11# For Python 3.11# Verify tkinter is availablepython3 -c"import tkinter; print('✓ Tkinter is ready')"

Linux (Debian/Ubuntu):

sudo apt-get install python3-tk

Linux (Fedora/RHEL):

sudo dnf install python3-tkinter

Windows:Tkinter is included with the official Python installer from python.org - no additional installation needed.

# Install Poetry if you haven't alreadycurl -sSL https://install.python-poetry.org| python3 -# Clone and install Mentalistgit clone https://github.com/sc0tfree/mentalist.gitcd mentalistpoetry install# Run Mentalistpoetry run mentalist

# Clone the repositorygit clone https://github.com/sc0tfree/mentalist.gitcd mentalist# Install Mentalistpip install.# Run Mentalistpython -m mentalist

# Install with Poetrypoetry install# Run testspoetry run pytest# Build distribution packagespoetry build

You can create a standalone executable using PyInstaller:

# Install PyInstaller (add to dev dependencies)poetry add --group dev pyinstaller# Build the executablepoetry run pyinstaller mentalist.spec# The executable will be in the dist/ directory

Mentalist should be used only forinformational purposes or onauthorized system audits.Do not use this tool to aid in illicit access to a system.

Mentalist is under the MIT License.

Contributions are always welcomed! Please let me know if there's a specific piece of functionality that you'd like to see built-in to the next version of Mentalist.

A special thanks to Craig Baker, who was instrumental in helping to develop the backend logic of Mentalist. Additionally, thank you to Shane Carlyon, whose Tkinter-fu was invaluable, and to Gregory Brewer, who contributed the artwork to this project.

I apologize to anyone offended by the built-in list ofSlang & Expletives, compiled from a variety of sources. The reality is that some people use truly heinous words for their credentials and this list is meant to help crack them.

• Ability to scrape sites as an attribute in the Base Words node.
• Add dictionaries and lists for more languages
• Add UK post codes to Append/Prepend Nodes
• Option to perform de-duplication of Base Words
• Mentalist Chain file differencing