Pathyxis is a web-based malware scanning tool designed to provide fast and reliable detection of malicious files by combining heuristic analysis with VirusTotal's powerful scanning engine.
-
File Upload Scanning: Upload files easily through a simple web interface for instant malware detection.
-
VirusTotal Integration: Leverages the VirusTotal API to access a vast database of malware signatures.
-
Heuristic Analysis: Performs basic heuristic checks to detect suspicious file patterns beyond known signatures.
-
Real-time Feedback: Displays near real-time scanning results to users.
-
Open Source & Lightweight: Built with Python (Flask) and a modern frontend stack, easy to deploy and customize.
-
Privacy-Focused: Files are scanned securely with no unnecessary data retention.
-
Python 3.7+
-
Node.js and npm
-
VirusTotal API key (register at VirusTotal)
git clone https://github.com/nevsky-dev/pathyxis.git
cd pathyxis
pip install -r requirements.txt
npm install
set VT_API_KEY=your_api_key_here
python app.py
npm run dev
Then open your browser at http://localhost:5173
-
Upload files through the web interface.
-
Pathyxis sends files to VirusTotal for scanning.
-
Results are displayed in real-time with detection details.
-
Heuristic checks provide an additional layer of analysis.
-
VirusTotal Free API Limits: Approximately 4 requests per minute and 500 requests per day.
-
File Size Restrictions: Files over 32 MB cannot be scanned via the free VirusTotal API.
-
Scan Latency: Some scans may take time; the app polls until the report is ready or times out.
-
Privacy: Uploaded files are sent to VirusTotal servers. Avoid uploading sensitive files unless you trust their policy.
-
Not a Production Security Tool: Intended as a demo and educational project only.
This project is licensed under the MIT License.
-
VirusTotal for their malware scanning API.
-
Flask and Requests for backend libraries.
-
Vite and frontend ecosystem for the modern UI.