gitwtfhub

wtf is fya?

ayam04/fya — explained in plain English

Analysis updated 2026-05-18

42PythonAudience · developerComplexity · 3/5LicenseSetup · easy

TL;DR

A Python security scanner that automatically probes a web server, Android app, or source folder for common vulnerabilities.

Mindmap

mindmap
  root((repo))
    What it does
      Scans for vulnerabilities
      Adapts to target type
      Orchestrates other tools
    Tech stack
      Python
      Docker
      Nuclei and sqlmap
    Use cases
      Test local web servers
      Scan Android APK files
      Run checks in CI pipelines
    Audience
      Security researchers
      Developers
      DevOps engineers

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

Why would anyone build with this?

REASON 1

Run an automated security scan against your own local development server.

REASON 2

Analyze an Android APK file for common mobile security issues.

REASON 3

Add a fail-on-severity security scan step to a CI pipeline.

REASON 4

Run static analysis over a source code directory to catch issues before deployment.

What's in the stack?

PythonDockerNucleisqlmapnmap

How it stacks up

ayam04/fya0xtotem/peek-dspyajeygore/llmwiki
Stars424242
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires Python 3.9 or newer, optional extras needed for APK analysis and headless-browser scanning.

Free to use and modify, but commercial use is not permitted under this license.

Wtf does this do

fya is a security scanning tool built in Python that you point at something you want to test, and it automatically tries to find weaknesses in it. It can scan a running web server on your own machine, an Android app file, or a folder of source code, and it works out on its own what kind of target it is looking at before running the right checks. The tool includes its own fast checks written in plain Python, and when other well known security tools like Nuclei, Nikto, sqlmap, nmap, testssl, jadx, or apkleaks are already installed on your system, it will call on them instead of duplicating what they already do well. In total it runs 58 different checks, each one linked back to a standard industry list of common security weaknesses called the OWASP Top 10, plus a mobile focused version of that list for Android apps. You choose how the scan behaves by picking a mode, such as web, api, mobile, or a full combined scan, and a profile that ranges from passive and read only, up to a more aggressive active probing style. The scanner adjusts its behavior based on what it detects about the target, and it slows itself down automatically if it notices errors or timeouts, so it does not overwhelm the system being tested. Results can be exported as console output, JSON, a security industry standard format called SARIF, Markdown, or a self contained HTML report, and the tool can be told to fail a build pipeline if it finds anything above a chosen severity level. Scanning anything other than your own local machine requires you to pass a flag confirming you have written authorization to test that target, and the README states plainly that scanning systems without permission may be illegal and is entirely the user's responsibility. The project includes a small deliberately vulnerable sample app so you can try the scanner safely before pointing it at anything real. It can be installed through pip or run inside Docker, and it needs Python 3.9 or newer. The project is released under the PolyForm Noncommercial license, which restricts commercial use.

Yoink these prompts

Prompt 1
Help me install fya with pip and run a safe profile scan against my local server.
Prompt 2
Explain the difference between the passive, safe, and aggressive scan profiles in fya.
Prompt 3
Walk me through scanning an Android APK file with fya and reading the report.
Prompt 4
How do I set up a baseline file so fya only fails CI on new findings?

Frequently asked questions

wtf is fya?

A Python security scanner that automatically probes a web server, Android app, or source folder for common vulnerabilities.

What language is fya written in?

Mainly Python. The stack also includes Python, Docker, Nuclei.

What license does fya use?

Free to use and modify, but commercial use is not permitted under this license.

How hard is fya to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is fya for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.