VIRUSPROTECT

Sentinel System

Advanced security analysis platform with AI-powered threat detection. Scan files, detect secrets, monitor web security.

Status: Online CI/CD Active MIT License

Core Features

Advanced Malware Scanning

VirusTotal integration with 70+ antivirus engines for comprehensive threat detection

  • Hash-based file analysis
  • Upload & deep scan
  • AI-powered explanations

Intelligent Secrecy Scanner

Multi-pattern detection for leaked API keys, credentials, and sensitive data

  • Project-wide scanning
  • Batch processing
  • AI remediation assistant

Web Security Monitor

HTTP header analysis and URL reputation checking

  • Security headers validation
  • Real-time monitoring
  • Config generator

Multi-Provider AI

Support for 6+ AI providers for enhanced security analysis

  • Claude, Gemini, GPT-4
  • DeepSeek, Grok, Ollama
  • Secure key management

Quarantine System

Isolated storage for malicious files with secure deletion

  • File isolation
  • Secure deletion
  • History tracking

Audit Trail

Complete logs of all security operations with timestamps

  • Real-time statistics
  • Operation history
  • JSON-based storage

Application Screenshots

Dashboard Overview

Dashboard Overview

Real-time security statistics and threat monitoring

File Scanning

File Scanning Interface

Drag & drop file upload with instant scanning

Scan Results

Scan Results

Comprehensive threat analysis from 70+ engines

AI Analysis

AI Threat Analysis

AI-powered threat explanations and recommendations

Secret Detection

Secret Detection

Identify leaked API keys and credentials

Web Monitoring

Web Security Monitor

HTTP header analysis and URL reputation

Security Analysis

Security Analysis

Detailed vulnerability assessments

Quarantine

Quarantine Management

Isolated storage for malicious files

System Architecture

Frontend Stack

React 19.2 Vite TailwindCSS Framer Motion React Router Axios React Dropzone React Markdown

Backend Stack

Node.js Express 5.2 Multer Axios Crypto CORS JSON DB dotenv

Project Structure

Virus-Protect/
├── client/               # React frontend (Vite)
│   ├── src/
│   │   ├── components/   # Reusable UI components
│   │   │   ├── AIConfigModal.jsx
│   │   │   ├── FileUpload.jsx
│   │   │   ├── ScanResult.jsx
│   │   │   └── Sidebar.jsx
│   │   ├── pages/        # Route-based pages
│   │   │   ├── DashboardHome.jsx
│   │   │   ├── ScanFilePage.jsx
│   │   │   ├── ScanProjectPage.jsx
│   │   │   ├── WebMonitorPage.jsx
│   │   │   ├── HistoryPage.jsx
│   │   │   └── QuarantinePage.jsx
│   │   ├── layouts/      # Layout wrappers
│   │   └── assets/       # Static resources
│   └── package.json
├── server/               # Express API server
│   ├── index.js          # Main server file
│   ├── db.json           # Local database
│   ├── uploads/          # Temporary file uploads
│   ├── quarantine/       # Quarantined files
│   └── package.json
└── .github/workflows/    # CI/CD pipelines

API Documentation

GET /api/history

Retrieve complete scan history with timestamps

Response:
[{
  "id": "uuid",
  "timestamp": "ISO-8601",
  "type": "file_scan",
  "result": {...}
}]
POST /api/scan/file

Upload and scan file with VirusTotal

Body: multipart/form-data
{
  "file": File
}
POST /api/scan/project

Scan entire project for secret leaks

Body:
{
  "path": "/project/path"
}
POST /api/scan/url

Analyze web URL security headers

Body:
{
  "url": "https://example.com"
}
POST /api/explain

Get AI-powered threat explanation

Body:
{
  "provider": "anthropic",
  "model": "claude-3-5-sonnet",
  "apiKey": "sk-...",
  "prompt": "Explain...",
  "context": {...}
}
DELETE /api/file

Delete quarantined file or history log

Body:
{
  "id": "uuid",
  "type": "quarantine"
}

External Integrations

VirusTotal API

Malware scanning with 70+ engines

Get API Key →

Anthropic Claude

Advanced AI threat analysis

Learn More →

Google Gemini

Fast security explanations

Learn More →

OpenAI GPT

Comprehensive reports

Learn More →

Installation Guide

1

Clone Repository

git clone https://github.com/Dharaneesh20/Virus-Protect.git
cd Virus-Protect
2

Backend Setup

cd server
npm install
echo "VT_API_KEY=your_key_here" > .env
echo "PORT=5000" >> .env
npm start

Server runs on http://localhost:5000

3

Frontend Setup

cd client
npm install
npm run dev

Application opens at http://localhost:5173

4

Configure AI Providers (Optional)

  • Click "AI Config" in dashboard
  • Select your preferred AI provider
  • Enter API key (stored securely)

Prerequisites

Node.js 18.x or 20.x
npm 9+
VirusTotal API Key
AI Provider Keys (Optional)

Security Features

Data Privacy

No sensitive data leaves your system except VirusTotal API calls

Encrypted Storage

AI API keys stored client-side with encryption

File Isolation

Quarantine system with isolated storage

Local Storage

JSON-based database, no credentials required

CORS Protection

Configured for localhost development

Responsible Disclosure

Follow security policy for vulnerabilities

CI/CD Pipeline Status

Multi-Version Testing (Node 18.x, 20.x)
Client Build Verification
Server Dependency Validation
Automated on Push/PR
View CI/CD Status →

Get Involved

GitHub Repository

Star, fork, and contribute to the project

View Repository →

Report Issues

Found a bug? Let us know!

Report Issue →

Security Reports

Responsible disclosure for vulnerabilities

Contact Security →

Contribute to VirusProtect

We welcome contributions from the cybersecurity community!

Add regex patterns
Implement tests
Docker setup
Network analyzer
PWA support
More AI providers