MCPcopy Index your code
hub / github.com/f0cker/crackq

github.com/f0cker/crackq @v0.1.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.1.2 ↗ · + Follow
155 symbols 610 edges 40 files 117 documented · 75% updated 22mo agov0.1.2 · 2023-12-29★ 9428 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

CrackQ

Author: Daniel Turner @f0cker_


Python 3 REST API & JS GUI for managing hashcat crack jobs in a queuing system.

PyPI license Quality Gate Status Security Rating Blackhat Arsenal Europe 2019

CrackQ Dashboard

Feature List

  • REST API
  • Remote Python client or JS GUI
  • Cracked passwords analysis and reporting, including AD dump analysis
  • Uses Hashcat API directly via libhashcat, no shell commands
  • Easy installation using docker containers
  • SQL, LDAP or SAML2 Authentication
  • Multi-user support with privilege separation for jobs
  • Job queues with pause/restore/move
  • Always supports the latest Hashcat version and algorithms
  • Email notifications when a hash cracks or job finishes
  • Intelligent queuing, new jobs added to the queue undergo a speed/show check immediately and will instantly show previously cracked hashes from the pot file without waiting
  • Automated Brain integration, Brain activates when it becomes efficient (uses above speed check)
  • Detailed job stats/charts for active jobs
  • Preconfigured rate-limiting
  • Markov stats pre-configured
  • Sample mask files included
  • Hashcat benchmark visualisations
  • Templates & Tasks allow you to save preset cracking techniques to create grouped jobs
  • Potfile++ - a wordlist automatically updated from the potfile daily can be optionally used with each job

Requirements

This tool has the following requirements:

  • Drivers

    • OpenCL drivers - these can be installed from a repository or downloaded from the relevant vendor. Tested using Intel runtime.
    • Nvida drivers
    • AMD drivers
  • Docker

  • Nvidia-runtime

  • Docker-compose

It is recommended to have a hefty server build with ample RAM/CPU power. However, the application has been tested on a VM with 8 cores and 4GB RAM so there should not be any issues with resources given that the server will need a good amount of resources for cracking anyway.

See the Wiki for installation and guides.

Official Discord Channel

Come hang out on Discord!

Porchetta Industries

Core symbols most depended-on inside this repo

val_filepath
called by 30
crackq/validator.py
del_check
called by 14
crackq/run_hashcat.py
delete
called by 11
crackq/cq_api.py
q_connect
called by 10
crackq/crackqueue.py
email_check
called by 8
crackq/cq_api.py
get_jobdetails
called by 7
crackq/cq_api.py
check_jobid
called by 7
crackq/cq_api.py
create_user
called by 5
crackq/cq_api.py

Shape

Method 68
Function 62
Class 25

Languages

Python100%

Modules by API surface

crackq/cq_api.py76 symbols
crackq/run_hashcat.py20 symbols
crackq/models.py9 symbols
crackq/crackqueue.py9 symbols
crackq/tests/test_queue.py8 symbols
crackq/validator.py5 symbols
crackq/auth.py5 symbols
crackq/migrations/env.py3 symbols
crackq/hash_modes.py3 symbols
utils/rq_addjob.py2 symbols
crackq/tests/test_validation.py2 symbols
crackq/migrations/versions/edc2261bfd64_.py2 symbols

For agents

$ claude mcp add crackq \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact