🚀 Cybersecurity AI Agent

An AI-powered cybersecurity assistant that scans IP addresses for potential threats using multiple security APIs.

📌 Features

👉 Scan IPs for threats using VirusTotal, Shodan, and AbuseIPDB
👉 AI-powered risk assessment using OpenAI SDK
👉 FastAPI backend & Svelte frontend
👉 Rate limiting & security best practices

---

📂 Project Structure

Cybersec-Assistant/
│── backend/
│   ├── main.py           # API entry point
│   ├── utility.py
│   ├── requirements.txt
│   ├── Dockerfile        # Backend Docker setup
│── frontend/             # Svelte frontend
│   ├── src/
│   ├── package.json
│   ├── tailwind.config.js
│   ├── Dockerfile        # Frontend Docker setup
│── compose.yaml          # Docker Compose configuration

---

🔧 Setup

1️⃣ Backend (FastAPI)

cd backend

python -m venv venv  # Create virtual environment
source venv/bin/activate  # (Linux/macOS)
venv\Scripts\activate  # (Windows)

pip install -r requirements.txt
uvicorn main:app --reload

2️⃣ Frontend (Svelte + TailwindCSS)

cd frontend
npm install
npm run dev

---

🚀 Usage

1️⃣ Open http://localhost:5173/ in your browser
2️⃣ Enter an IP address and click Scan
3️⃣ View AI-powered threat analysis

---

🛠️ API Endpoints

Method	Endpoint	Description
GET	/scan/ip/{ip}	Scan IP for threats

---

🔒 Security

👉 CORS Protection in FastAPI
👉 API Key Handling for external services

---

🐳 Running with Docker

1️⃣ Build and Run Containers

Ensure Docker is installed, then run:

docker compose up --build

2️⃣ Stop Containers

docker compose down

3️⃣ Rebuild and Restart

docker compose up --force-recreate --build

---

💜 License

MIT License

---

⭐ Contribute

1. Fork the repo
2. Create a new branch
3. Make changes & commit
4. Open a pull request

---

🔧 Git Setup

Now commit & push it to GitHub:

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/MohibShaikh/Cybersec-Assistant.git
git push -u origin main