<<<<<<< HEAD

Sentra is an open-source, agentic, and autonomous network security assistant. It discovers network assets, runs reconnaissance (Nmap), correlates vulnerabilities (CVEs), and structures audit-ready reports. Future plans include LLM/agent integration and a GUI.

• Network asset discovery
• Nmap-based scanning
• CVE correlation (local/remote)
• Structured asset inventory
• CLI interface (GUI coming soon) ======= Sentra is an open-source, AI-augmented internal network auditing tool designed to autonomously discover network hosts, identify vulnerabilities, and generate audit-ready reports. smart first, modular second, and fully offline third.

80f07f748dc36f1c09f8ae34bc1a1a7126a167a3

# Clone repo
# Create virtualenv and activate
python3 -m venv .venv
source .venv/bin/activate.fish
pip install -r requirements.txt

python -m sentra.cli.main --target 192.168.1.0/24 --verbose

• Copy .env.example to .env and fill in secrets/API keys as needed.

• Add new agents in sentra/core/agents.py
• Add new scanners in sentra/core/scanner.py
• Add models in sentra/core/models.py

• Never commit .env or secrets
• Validate all user input
• Use subprocess securely (never shell=True)
• Rotate logs and restrict permissions

<<<<<<< HEAD

Pull requests welcome! See CONTRIBUTING.md for guidelines.

Run Nmap scan against live hosts to find active/hidden ports

80f07f748dc36f1c09f8ae34bc1a1a7126a167a3