Skip to content

Nguyen-The-Lap/Cool

Repository files navigation

Cool Logo

Cool

⚡ Next-Generation Threat Protection


❄️ Stay Cool, Stay Protected

Cool delivers enterprise-grade security with a lightweight footprint. Our next-gen engine combines behavioral analysis, machine learning, and real-time threat intelligence to keep your systems safe against the latest cyber threats.

Cool Dashboard Preview

✨ Key Features

🚀

Lightning Fast

Optimized scanning engine with minimal impact on system performance, ensuring your device stays fast and responsive.

🔒

Advanced Protection

Multi-layered security with behavioral analysis, machine learning, and real-time threat intelligence.

🌐

Cloud-Powered

Always up-to-date with the latest threat definitions and security intelligence from our global network.

🛡️ Security Capabilities

Real-time Protection

Continuous monitoring of system activities to block threats before they can execute.

Behavioral Analysis

Detects and blocks zero-day threats by analyzing program behavior.

Cloud Intelligence

Leverages global threat intelligence for up-to-the-minute protection.

Performance Optimization

Smart resource management to minimize impact on system performance.

Custom Scanning

Flexible scanning options including quick, full, and custom scans.

Threat Quarantine

Safely isolate and manage detected threats for further analysis.

🔍 Smart Features

  • AI-Powered - Learns from new threats

  • Custom Rules - Create your own detection rules

  • Detailed Reports - Understand every threat

    • Resource usage patterns
  • Model Architecture:

    • Random Forest classifier with optimized hyperparameters
    • Automated feature selection

🚀 Quick Start

Prerequisites

  • Python 3.10 or higher
  • pip (Python package manager)
  • Git

Installation

# Clone the repository
git clone https://github.com/Nguyen-The-Lap/Antivirus-Prototype-Project.git
cd Antivirus-Prototype-Project

# Create and activate a virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install the package in development mode
pip install -e .

🛠 Usage

Basic Commands

# Run a quick scan on a directory
cool scan /path/to/scan

# Run a full system scan
cool scan --full

# Monitor a directory in real-time
cool monitor /path/to/watch

# Check the status
cool status

# Update virus definitions
cool update

# View logs
cool logs

Advanced Usage

# Scan with custom sensitivity
cool scan /path --sensitivity high

# Exclude directories from scan
cool scan /path --exclude /path/exclude1,/path/exclude2

# Generate a detailed report
cool scan /path --report report.json

# Run in daemon mode
cool daemon start

📊 Performance Metrics

Feature Performance
Scan Speed Up to 10,000 files/minute
Memory Usage < 100MB average
CPU Usage < 5% during idle, < 30% during scans
Startup Time < 1 second

🛡️ Security Features

Real-time Protection

  • Monitors file system activities
  • Blocks malicious processes
  • Prevents unauthorized changes

Behavioral Analysis

  • Detects zero-day threats
  • Analyzes process behavior
  • Identifies suspicious patterns

Cloud Integration

  • Automatic updates
  • Threat intelligence sharing
  • Community protection

📚 Documentation

For detailed documentation, please visit our documentation site.

API Reference

from antivirus import CoolAntivirus

# Initialize the antivirus engine
av = CoolAntivirus()

# Scan a file
result = av.scan_file("/path/to/file.exe")

# Scan a directory
results = av.scan_directory("/path/to/directory")

# Get system status
status = av.get_status()

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

  1. Report Bugs: File an issue on our issue tracker
  2. Suggest Features: Share your ideas for new features
  3. Submit Pull Requests: Contribute code improvements
  4. Improve Documentation: Help us make the docs better

Development Setup

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

# Run linter
flake8

# Run type checking
mypy .

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Thanks to all contributors who have helped make Cool better
  • Built with ❤️ by the security community
  • Icons by Icons8

Made with ❤️ by Nguyen The Lap

© 2025 Cool Antivirus. All rights reserved.

About

A simple repo for antivirus prototype

Resources

License

Stars

Watchers

Forks

Releases

No releases published