___    ____  ___  __  _______
   /   |  / __ \/ __ \/ / / / ___/
  / /| | / /_/ / /_/ / / / /\__ \ 
 / ___ |/ _, _/ __  / /_/ /___/ / 
/_/  |_/_/ |_|\____/\____//____/  

Argus is a full-stack Vulnerability Assessment and Penetration Testing (VAPT) Report Automation Dashboard.

Security engineers frequently spend up to 40% of their engagement hours manually formatting Word documents, mapping CVSS scores, and drafting mitigation strategies. Argus eliminates this bottleneck. By providing a centralized, AI-powered platform to log vulnerabilities, track engagements, and instantaneously generate professional PDF deliverables, Argus shifts the focus back to where it belongs: breaking things.

Designed for specialized VAPT teams, solo red teamers, and rigorous bug bounty hunters, Argus is a highly hardened, deploy-anywhere security command center.

• Engagement Management: Isolate and track vulnerabilities logically per-client or per-pentest project.
• Vulnerability Tracking: Rich classification with automated mapping to the OWASP Top 10.
• CVSS Intelligence: Automated CVSS severity parsing and calculation alignment.
• AI-Powered Analyst: Leverages Google Gemini to auto-generate deeply technical, step-by-step developer remediation instructions based directly on your payload and findings.
• Analytics SOC Dashboard: Real-time severity doughnut charts, an OWASP frequency heatmap, and algorithmic project-wide Risk Scoring calculations.
• Automated Deliverables: One-click, native compilation to a polished, professional PDF Report utilizing Jinja2 and WeasyPrint pipelines without relying on external SaaS formatting.
• Hardened Security: Protected by strict JWT authentication (HTTPOnly + silent refresh), aggressive IP rate limiting, strict CORS, and CSP origin lockdown.
• Production Ready: One-command orchestrator deployment via docker-compose.

Deploy Argus locally or on a VPS in under three minutes.

• Docker and docker-compose installed natively
• Git
• A Google Gemini API Key

1. Clone the repository:

   git clone https://github.com/thearjunl/Argus.git
   cd Argus

2. Configure your environment:

   cp .env.example .env

   Edit .env inside your preferred editor to inject your API keys and secure your database.

3. Deploy the fleet:

   docker-compose up -d --build

The dashboard will be securely exposed at http://localhost.

To run the automated test suite locally:

1. Verify Test Environment: Run the setup script to instantly instantiate the required Postgres schema:

   bash scripts/setup_test_db.sh

2. Execute Pytest:

   cd argus-backend
   pytest --cov=app --cov-report=term-missing -v

3. Frontend Validations:

   cd argus-frontend
   npm test

The .env file requires the following keys for secure compilation:

Argus/
├── argus-backend/
│   ├── app/
│   │   ├── models/           # SQLAlchemy DB Models
│   │   ├── routers/          # FastAPI API endpoints
│   │   ├── schemas/          # Pydantic input/output schemas
│   │   ├── templates/        # Jinja2 HTML Report Templates
│   │   ├── utils/            # JWT, Gemini, PDF Handlers
│   │   └── main.py           # FastAPI entry point & Middleware config
│   ├── Dockerfile
│   └── requirements.txt
├── argus-frontend/
│   ├── app/
│   │   ├── dashboard/        # Next.js Analytics & Operations Pages
│   │   ├── login/            # Auth UI
│   │   ├── layout.tsx
│   │   └── page.tsx          # Landing Splash
│   ├── components/           # Reusable Tailwind/Radix UI modules
│   ├── lib/                  # Axios Interceptors & TS Interfaces
│   ├── Dockerfile
│   ├── next.config.ts        # CSP & Security Headers configuration
│   └── package.json
├── docker-compose.yml        # Multi-container orchestration
├── nginx.conf                # Reverse proxy traffic routing configs
├── README.md
└── .env.example

Core routing table. (All endpoints except /auth/login and /auth/register require Bearer / Token auth).

Placeholder: Dashboard Analytics Screenshot

Placeholder: Vulnerability Tracking Table Screenshot

Placeholder: Exported PDF Report Preview Screenshot

• Mobile responsive UI
• Multi-user team support and RBAC
• CVE database integration
• Slack/email alert notifications
• CVSS v4.0 scoring support
• Export to DOCX format

Contributions make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MIT License. See LICENSE for more information.

Built by Arjun L — MCA Cybersecurity & Full-Stack AI
View GitHub Profile