Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

addcontent/CVE-Lens

Repository files navigation

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.

Docker Ready Python 3.8+ License Live Site

Dashboard View Vulnerability View Light Mode View Dark Mode View

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

addcontent08@gmail.com

About

A modern CVE retrieval dashboard written in Svelte.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /