How gokul-cybersec/ai_malware_analyser works
AI Malware Analyzer accepts suspicious files, validates and hashes them, then processes them asynchronously through static analysis, feature extraction, ML classification, threat-intelligence enrichment, and report generation. Results and sample metadata are persisted for API retrieval and displayed in a Next.js SOC dashboard. The README documents the Redis/Celery processing architecture and major analysis capabilities; some subsystem wiring is only documented, so those links are marked accordingly.
Main entry points: routes.py API Routes · tasks.py Analysis Pipeline · worker.py Celery Task · api.ts Frontend API Client
Components 21
Dashboard
- Analysis Dashboard
frontend/src/app/page.tsx - Sample Details
frontend/src/app/analysis/[id]/page.tsx - Frontend API Client
frontend/src/lib/api.ts
API and Intake
- FastAPI App
backend/app/main.py - API Routes
backend/app/api/routes.py - File Validation
backend/app/services/validator.py - File Hashing
backend/app/services/hasher.py
Analysis Pipeline
- Analysis Pipeline
backend/app/tasks.py - Static PE Analysis
backend/app/analysis/static_analyzer.py - Feature Extraction
backend/app/analysis/feature_extractor.py - ML Classification
backend/app/ml/predict.py - Model Training
backend/app/ml/train.py - VirusTotal Enrichment
backend/app/services/vt_client.py - AI Report Generation
backend/app/services/report_generator.py - Sandbox Interface
backend/app/sandbox/sandbox_controller.py
Persistence and Workers
- Redis Broker
- Celery Task
backend/app/worker.py - Analysis Database
backend/app/models/database.py
Other components
- Security Analyst
- VirusTotal
- Gemini LLM
Connections 24
- Security Analyst → Analysis Dashboard: uploads sample
- Analysis Dashboard → Frontend API Client: requests data
- Sample Details → Frontend API Client: requests details
- Frontend API Client → FastAPI App: calls API
- FastAPI App → API Routes: registers routes
backend/app/main.py - API Routes → File Validation: validates upload
backend/app/api/routes.py - API Routes → File Hashing: hashes upload
backend/app/api/routes.py - API Routes → Analysis Database: stores sample
backend/app/api/routes.py - API Routes → Celery Task: dispatches task
backend/app/api/routes.py - Celery Task → Redis Broker: uses broker
- Redis Broker → Celery Task: delivers task
- Celery Task → Analysis Pipeline: runs pipeline
backend/app/worker.py - Analysis Pipeline → Static PE Analysis: analyzes file
backend/app/tasks.py - Analysis Pipeline → Feature Extraction: extracts features
backend/app/tasks.py - Analysis Pipeline → ML Classification: classifies sample
backend/app/tasks.py - ML Classification → Model Training: loads model from
backend/app/ml/predict.py - Analysis Pipeline → VirusTotal Enrichment: enriches analysis
backend/app/tasks.py - VirusTotal Enrichment → VirusTotal: queries
backend/app/services/vt_client.py - Analysis Pipeline → AI Report Generation: generates report
backend/app/tasks.py - AI Report Generation → Gemini LLM: may delegate
- Analysis Pipeline → Analysis Database: persists results
backend/app/tasks.py - API Routes → Sandbox Interface: runs sandbox analysis
backend/app/api/routes.py - API Routes → Analysis Database: reads sample and reports
backend/app/api/routes.py - Security Analyst → Sample Details: views findings