whatisgithub

What is autohunter?

stanleynull/autohunter — explained in plain English

Analysis updated 2026-05-18

111PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A self hosted, LLM driven system that automates bug bounty vulnerability hunting across discovered targets, with human review before submission.

Mindmap

mindmap
  root((repo))
    What it does
      Collect targets via FOFA
      Hunt vulnerabilities with LLM workers
      AI review of findings
      Human final review
    Tech stack
      Python
      FastAPI
      Vue 3
      Docker
    Use cases
      Automate bug bounty hunting
      Scan authorized education targets
      Review AI found vulnerabilities
    Audience
      Security researchers
      Bug bounty hunters
    Requirements
      LLM API key
      Written authorization
      Docker environment

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 build with it?

USE CASE 1

Run continuous, automated vulnerability hunting against targets you have written authorization to test.

USE CASE 2

Discover candidate targets automatically through the FOFA internet asset search service.

USE CASE 3

Let an AI reviewer filter out false positives before you spend time reviewing findings.

USE CASE 4

Auto-fill education sector bug bounty reports by looking up which university a target belongs to.

What is it built with?

PythonFastAPIVue 3Docker

How does it compare?

stanleynull/autohunter2417467487-hub/trend2video-protencent-hunyuan/hy-embodied-rxbrain-1.0
Stars111111111
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity4/55/5
Audiencedevelopervibe coderresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker, a paid LLM API key, and ideally a FOFA key, first build also compiles the frontend and installs scanning tools, taking 5 to 15 minutes.

Free to use, modify, and share for noncommercial purposes only, as long as you credit the original author.

So what is it?

AutoHunter is a self hosted system that automates bug bounty style vulnerability hunting, built for security researchers who submit findings to programs like EduSRC, the education sector bug bounty platform in China. The idea is that you set the system running on a server around the clock, and instead of manually testing targets yourself, you spend your time reviewing the findings it surfaces before deciding what to submit. It works as a pipeline of cooperating pieces. A collector gathers candidate targets, either by querying the FOFA internet asset search service or from a manual list you provide, then checks whether each target is reachable and scores it. Each target is then handed to its own worker, which uses a large language model together with real security tools such as nmap, nuclei, sqlmap, and httpx to investigate it and attempt to find a genuine vulnerability, submitting anything it finds. A reviewer step then uses AI to filter out incomplete results or false positives before anything reaches you, and a dashboard lets you watch what every worker is doing in real time and make the final call on what gets submitted. For education sector targets, it can also automatically look up which university a given IP address or domain belongs to, to help fill out report details. The project explicitly states it is licensed under CC BY NC 4.0, meaning noncommercial use only, and that it must only be used against targets you have clear written authorization to test. It runs through Docker and Docker Compose on Linux, Windows with WSL2, or macOS, and setup is handled by an install script that walks you through supplying a language model API key, which is required, and a FOFA key, which is recommended for automatic target discovery. The backend is written in Python with FastAPI and SQLAlchemy, and the frontend uses Vue 3. The author describes this as a demo level project shared to help others, not a polished production tool.

Copy-paste prompts

Prompt 1
Walk me through running the install.sh script to deploy AutoHunter on a Linux server with Docker.
Prompt 2
Help me write a FOFA query to find a specific type of authorized target for this tool to scan.
Prompt 3
Explain how the collector, worker, and reviewer stages work together in this pipeline.
Prompt 4
Show me how to set AUTOHUNTER_API_TOKEN so my deployment isn't open to the public internet.

Frequently asked questions

What is autohunter?

A self hosted, LLM driven system that automates bug bounty vulnerability hunting across discovered targets, with human review before submission.

What language is autohunter written in?

Mainly Python. The stack also includes Python, FastAPI, Vue 3.

What license does autohunter use?

Free to use, modify, and share for noncommercial purposes only, as long as you credit the original author.

How hard is autohunter to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is autohunter for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.