Skip to content

shlok926/Lattix-Q

Repository files navigation

Lattix-Q Logo

Lattix - Q

Enterprise Post-Quantum Cryptography (PQC) Migration & Risk Assessment Platform

An advanced, premium cybersecurity dashboard that inventories legacy cryptographic assets, simulates Shor's and Grover's quantum attacks, profiles post-quantum lattice-based algorithms, and automates PQC transition auditing.

Python Version React Version FastAPI Qiskit Version Docker Ready License Status

Executive SummaryArchitectureQuickstartEngineering ConsiderationsReferences


Table of Contents

1. Executive Summary 9. Design Decisions
2. Scope & Background 10. Engineering Considerations
3. Key Capabilities 11. Future Improvements
4. Architecture Overview 12. Contributing
5. Tech Stack 13. References
6. Repository Structure 14. Show Your Support
7. Quickstart 15. Author & Contact
8. Troubleshooting

1. Executive Summary

Lattix-Q is a unified cybersecurity risk-management platform designed to assist enterprises in auditing legacy public-key infrastructures (RSA, ECC) and orchestrating transitions to post-quantum standards. The platform models real-time computational overhead, analyzes application source code for vulnerable parameters, and generates cryptographic health reports ready for compliance audits.


2. Scope & Background

The Threat: Store Now, Decrypt Later (SNDL)

Modern secure data communications rely heavily on public-key cryptography (like RSA and ECC). However, quantum computers utilizing Shor's Algorithm will be capable of breaking these mathematical problems in the future. Adversaries are actively harvesting encrypted enterprise data today (SNDL) to decrypt it once cryptographically relevant quantum computers (CRQCs) emerge.

The Mandate: Transition to Post-Quantum Cryptography (PQC)

Enterprises must transition immediately to lattice-based cryptographic algorithms. Government directives such as NIST SP 800-219 and the NSA Commercial National Security Algorithm Suite (CNSA 2.0) mandate complete migration to post-quantum standards (ML-KEM, ML-DSA) by 2030-2033.


3. Key Capabilities

Quantum Attack Lab AI Code Scanner Crypto Workbench Compliance & Reports
Simulate factorization and key-recovery using Shor's and Grover's algorithms. Scan source code repositories to locate legacy cipher suites and auto-apply patches. Run real-time performance benchmarks comparing ciphers under simulated network loads. Generate professional PDF reports scoring transition maturity against NIST mandates.
  • Quantum Attack Laboratory: Estimating logical qubits required to crack ciphers dynamically.
  • AI Code Scanner: Parse source files to identify cryptographic configurations and recommend secure updates.
  • PQC Benchmark Center: Metric charts displaying execution times and key/ciphertext payload sizes.
  • Compliance Blueprints: Interactive checklist scoring readiness for CNSA 2.0 timelines.

4. Architecture Overview

Lattix-Q uses a decoupled, containerized microservices mesh orchestrated via docker-compose and routed through an Nginx reverse proxy acting as a unified API Gateway.

flowchart TB
    %% Subgraphs representing styled containers
    subgraph UI ["Ingress & Frontend Portal"]
        Client["User Browser / CLI"]
        Nginx["Nginx Reverse Proxy (Port 80/443)"]
        Frontend["React Frontend Console (Port 3000)"]
    end

    subgraph GW ["Authentication & Gateway Core"]
        Gateway["API Gateway (Port 8000)"]
        Postgres[("PostgreSQL Database (Port 5432)")]
    end

    subgraph LAB ["Quantum & Cryptographic Services"]
        AttackSvc["Quantum Attack Engine (Port 8001)"]
        ClassicalSvc["Classical Crypto Audit (Port 8002)"]
        PQCSvc["PQC Algorithm Suite (Port 8003)"]
        BenchmarkSvc["Performance Benchmarking (Port 8004)"]
        ReportSvc["Compliance Report Engine (Port 8005)"]
        AISvc["AI Threat Analyst (Port 8006)"]
    end

    subgraph ASYNC ["Asynchronous Task Queue"]
        Redis["Redis Message Broker (Port 6379)"]
        CeleryWorker["Celery Simulation Worker"]
    end

    subgraph MON ["Observability Stack"]
        Prometheus["Prometheus Telemetry (Port 9090)"]
        Grafana["Grafana Dashboards (Port 3001)"]
    end

    %% Flow Connections
    Client --> Nginx
    Nginx -->|Routes static UI| Frontend
    Nginx -->|Routes API calls| Gateway
    
    Gateway -->|JWT Auth & DB Session| Postgres
    Gateway -->|API calls| LAB
    
    AttackSvc -->|Pub/Sub Trigger| Redis
    Redis -->|Process simulation| CeleryWorker
    
    Gateway -->|Collect metrics| Prometheus
    Prometheus -->|Visual dashboards| Grafana

    %% Node styling classes
    classDef uiClass fill:#1d3557,stroke:#457b9d,stroke-width:2px,color:#fff;
    classDef gwClass fill:#1b4d3e,stroke:#2d6a4f,stroke-width:2px,color:#fff;
    classDef dbClass fill:#7b1113,stroke:#9b2226,stroke-width:2px,color:#fff;
    classDef labClass fill:#4a148c,stroke:#7b1fa2,stroke-width:2px,color:#fff;
    classDef asyncClass fill:#e65100,stroke:#f57c00,stroke-width:2px,color:#fff;
    classDef monClass fill:#006064,stroke:#00838f,stroke-width:2px,color:#fff;

    class Client,Nginx,Frontend uiClass;
    class Gateway gwClass;
    class Postgres,Redis dbClass;
    class AttackSvc,ClassicalSvc,PQCSvc,BenchmarkSvc,ReportSvc,AISvc labClass;
    class CeleryWorker asyncClass;
    class Prometheus,Grafana monClass;

    %% Subgraph styling (dark containers)
    style UI fill:#18181b,stroke:#27272a,stroke-width:1px,color:#fff
    style GW fill:#18181b,stroke:#27272a,stroke-width:1px,color:#fff
    style LAB fill:#18181b,stroke:#27272a,stroke-width:1px,color:#fff
    style ASYNC fill:#18181b,stroke:#27272a,stroke-width:1px,color:#fff
    style MON fill:#18181b,stroke:#27272a,stroke-width:1px,color:#fff
Loading

5. Tech Stack

  • Frontend: React 18, TypeScript 5, Vite 5, Tailwind CSS 3, Recharts, Lucide React
  • Backend Framework: Python 3.11, FastAPI, Celery, Uvicorn
  • Quantum Modeling: Qiskit 1.x (for period-finding algorithms)
  • Cryptographic Libs: liboqs (Integration for Kyber/Dilithium), PyCryptodome
  • Databases & Cache: PostgreSQL 15, Redis 7 (Broker & Result backend)
  • Infrastructure: Docker Compose, Nginx, Prometheus, Grafana

6. Repository Structure

Lattix-Q/
├── assets/                  # Branding images and generated logos
├── docker/                  # Nginx proxy routing files
│   └── nginx/
│       └── default.conf
├── frontend/                # React (TypeScript + Vite) Application
│   ├── src/
│   │   ├── components/      # Common shell components
│   │   ├── pages/           # Core layout modules (Dashboard, Scanner)
│   │   └── index.css        # Global CSS rules
│   └── package.json
├── services/                # Containerized microservices
│   ├── ai-analyst-service/  # LLM context assistant
│   ├── api-gateway/         # Unified ingress validator
│   ├── benchmark-service/   # Encrypt/Decrypt profiling
│   ├── classical-crypto/    # Legacy auditing ciphers
│   ├── pqc-service/         # Liboqs implementations
│   ├── quantum-attack/      # Qiskit simulator engine
│   └── report-service/      # Audit scoring builder
├── docker-compose.yml       # Production orchestrator
└── README.md

7. Quickstart

Prerequisites

Make sure your system has the following installed:

Running the Localhost Environment

  1. Clone the Repository:

    git clone https://github.com/shlok926/Lattix-Q.git
    cd Lattix-Q
  2. Initialize Environment Variables:

    cp .env.example .env

    Supply API keys (e.g. Anthropic key for the AI Threat Analyst) inside .env if desired.

  3. Build and Spin Up the Containers:

    docker-compose up -d --build
  4. Access the Interfaces:


8. Troubleshooting

Port Conflicts

If you receive port conflict errors (e.g. port 80 or 3000 is already in use by another app):

  1. Open docker-compose.yml in your editor.
  2. Edit the external port mappings under the nginx or frontend blocks (e.g. change "80:80" to "8080:80").
  3. Re-run docker-compose up -d.

Docker Daemon Not Running

If you see error during connect: daemon not response, make sure Docker Desktop is open and running on your taskbar before launching commands.


9. Design Decisions

  • Microservices Partitioning: Separating cryptographic calculations from core page state ensures that a heavy period-finding simulation doesn't degrade client UI responsiveness.
  • Celery Async Workers: Shor's and Grover's algorithms are computationally heavy; offloading them to Celery ensures the API Gateway does not timeout waiting for results.
  • Client-Side Cron Backfilling: Built-in background logic computes daily cron offsets during offline presentations to maintain data integrity in the scan list.

10. Engineering Considerations

  • Quantum Simulation Restrictions: Standard server CPUs struggle to execute Shor's algorithm for keys above 16 bits. Lattix-Q uses mathematical scaling regressions to calculate physical/logical qubit requirements for keys of standard length (e.g. RSA-2048) rather than running real simulations.
  • Cryptographic Agility: Key encapsulation (KEM) ciphers are bound to standard wrapper interfaces so that transition targets can adapt when NIST releases future FIPS amendments.

11. Future Improvements

  • Active DAST Endpoint Scanning: Extending the CLI scanner capabilities to dynamically probe live target services and audit their TLS cipher suites for classical ciphers.
  • Identity Provider Integration: Migrating local credentials database to SAML 2.0 / OpenID Connect (OIDC) via Okta or Microsoft Entra ID (Azure AD).
  • Virtual HSM Emulation: Integrating virtual Hardware Security Modules (SoftHSM) to validate physical post-quantum signature verification overhead.
  • Kubernetes Orchestration: Publishing Helm charts to support deploying Lattix-Q microservices across scalable EKS/GKE clusters.

12. Contributing

Contributions, suggestions, and feedback are highly welcome!

  • Got suggestions or feature requests? Feel free to open a new Issue or share your ideas.
  • Want to contribute? Feel free to fork this repository, make your changes, and submit a Pull Request.

13. References


Show Your Support

Love Lattix-Q? Help us grow:

  • Star the repository (GitHub Star Button)
  • Report bugs (GitHub Issues)
  • Suggest features (GitHub Discussions)
  • Share with others (LinkedIn/Twitter)
  • Contribute code (Pull Requests)

Author & Contact

Shlok Thorat
Let's connect on LinkedIn, collaborate, and build amazing things together!

Email GitHub LinkedIn

Made with 💖 by Shlok! for Cybersecurity Innovation • Back to Top

About

An enterprise-grade Post-Quantum Cryptography (PQC) Migration & Risk Management Platform. Features quantum attack simulations, AST-based PQC code scanning, compliance scoring, and an AI-powered PQC migration co-pilot.

Topics

Resources

License

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors