Skip to content

Shrestha-Kumar/Malware-Analysis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ Futuristic Malware Scanner

A futuristic-looking malware scanner web app built with FastAPI, TailwindCSS, and JavaScript.
This tool performs static analysis on uploaded files (like .exe, .pdf, .docx, .txt) and flags malicious indicators using hashing and YARA rules.

๐Ÿš€ Features

  • โš™๏ธ FastAPI backend for scanning and malware detection
  • ๐Ÿง  YARA-based static analysis with custom rules
  • ๐ŸŒ Beautiful futuristic UI with Tailwind CSS
  • ๐Ÿ“‚ Supports file uploads: .exe, .pdf, .docx, .txt, etc.
  • ๐Ÿงช Flags malicious, suspicious, or clean files with a clear verdict
  • ๐Ÿ’พ (Optional) Saves scan results for future logs

๐Ÿงฐ Technologies Used Layer Stack Frontend HTML, TailwindCSS, JavaScript Backend Python, FastAPI Static Analysis YARA, hashlib, python-magic Deployment Localhost or Render/Vercel (optional) ๐Ÿงช Sample Verdicts

  • โœ… Clean: No malicious indicators found.
  • โš ๏ธ Suspicious: Large file, unusual extension, or MIME mismatch.
  • โŒ Malicious: Matches known YARA or hash-based signatures.

๐Ÿง‘โ€๐Ÿ’ป How to Run Locally ๐Ÿ”น 1. Clone the Repo

git clone https://github.com/YOUR_USERNAME/malware_scanner.git cd malware_scanner

๐Ÿ”น 2. Backend Setup (FastAPI + Python)

cd backend

python -m venv venv

venv\Scripts\activate # or source venv/bin/activate on Linux/Mac

pip install -r ../requirements.txt

uvicorn main:app --reload

๐Ÿ”น 3. Frontend Setup

cd ../frontend

Just open index.html in your browser

โš ๏ธ File Size Limit Files over 100MB are flagged as suspicious. Max size supported ~200MB (configurable). ๐Ÿ”’ Security Considerations

  • โœ”๏ธ Limits on file size and type
  • โœ”๏ธ CORS enabled for safe cross-origin use
  • โœ”๏ธ Sanitized file inputs
  • โœ”๏ธ No dynamic execution (safe static scan only)

๐Ÿง  YARA Rules Located in backend/yara_rules/ โ€” feel free to improve and contribute! ๐Ÿ“œ License MIT License. Use responsibly and feel free to contribute! ๐Ÿ™Œ Contributors @Ujjwal030406 @S2-ABSURD ๐Ÿ“ฌ Contact

For questions, ideas or improvements:
๐Ÿ“ง Email: your-ujjwal6440@gmail.com

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors