CVE-Lens - Your Real-Time Vulnerability Guardian 🛡️

Welcome to CVE-Lens, A simple web application dashboard written in svetlte 5, it compiles and displays vulnerabilities from the NVD API, in real time.

Modern dashboard with real-time vulnerability insights

🌐 Live Demo

Check out the live application at https://cve.ujaotech.com/

📖 Features

Real-Time Monitoring

• Live vulnerability feed with severity classification
• Instant statistics and trend analysis
• Smart filtering and advanced search capabilities
• Light and dark mode themes

Developer Tools

• GitHub PoC integration
• Nuclei template detection
• Direct NVD reference links

🚀 Quick Start

Prerequisites

• Python 3.8 or newer
• SQLite3 database
• NVD API Key (recommended)

Installation

🐳 Docker Setup

Build and run the Docker container with the following command:

docker build -t cve-monitor .
docker run -d -p 5000:5000 --name cve-monitor cve-monitor

See DOCKER.md for detailed Docker instructions.

🛠️ Production Deployment

Using Waitress (Production Server)

For a production environment, it's recommended to use a production-grade WSGI server like Waitress. You can run the app with Waitress using the following command:

waitress-serve --host 0.0.0.0 --port 5000 app:app

Using Docker

🐳 Docker Setup

Build and run the Docker container with the following command:

docker build -t cve-monitor .
docker run -d -p 5000:5000 --name cve-monitor cve-monitor

Development Instructions

Python Backend

1. Install Dependencies: Navigate to the backend directory and install the required Python packages:

   pip install -r requirements.txt

2. Run the Backend: Start the backend server:

   flask run

Svelte Frontend

1. Install Node.js Dependencies: Navigate to the frontend directory and install the necessary packages:

   npm install

2. Run the Frontend: Start the frontend development server:

   npm run dev

One-Click Deployment with Coolify

1. Connect Your Git Repository: In your Coolify dashboard, select your server and create a new resource. Choose "Public Repository" and paste the URL: https://github.com/addcontent08/CVE-Lens.git.
2. Configure Build Pack: Coolify defaults to Nixpacks. Click on it and select Docker from the dropdown menu.
3. Set Environment Variables: Navigate to the "Environment Variables" tab and add your NVD_API_KEY and GITHUB_TOKEN.
   • NVD_API_KEY: Your NVD API key for enhanced data retrieval.
   • GITHUB_TOKEN: Your GitHub token for accessing private repositories and PoC links.
4. Deploy: Click the "Deploy" button. Coolify will automatically clone the repository, build the Docker image, and run the application.

One-Click Deployment with Dokploy

1. Add Project: In your Dokploy dashboard, go to "Projects" and click "Create Project".
2. Connect Git Repository: Select "GitHub" as the source and connect your repository (addcontent08/CVE-Lens).
3. Configure Deployment: Dokploy should automatically detect the docker-compose.yml file. Ensure the correct build settings are selected.
4. Add Environment Variables: Go to the "Environment" section and add your NVD_API_KEY and GITHUB_TOKEN.
5. Deploy: Save the configuration and trigger a new deployment.

🤝 Contributing

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

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

📝 License

This project is MIT licensed. See LICENSE for details.

🙏 Acknowledgments

• NVD for their comprehensive vulnerability database
• The amazing open-source community
• All our contributors and users

---

Built with ❤️ addcontent08. contents and contributions are always welcome!

📞 Contact

[email protected]