Kryptos-AI is a powerful, multi-agent security pipeline designed to protect users from phishing, scams, and digital threats in real-time. It combines a Chrome extension for immediate detection, a sophisticated multi-agent backend for deep analysis, and a modern dashboard for comprehensive reporting.

├── extension/          # Chrome Extension (Manifest V3)
│   ├── popup.js/html   # Tool for manual text/screenshot analysis
│   ├── content.js      # Link hover detection and page scanning
│   └── background.js   # Orchestrator for extension events
├── backend/            # FastAPI Backend
│   ├── agents/         # Multi-agent logic (Scout, Analyst, Educator)
│   ├── main.py         # Orchestrator and WebSocket server
│   ├── contracts.py    # Data models (Pydantic) for agent communication
│   └── .env            # Environment secrets (API Keys, MongoDB)
└── webapp/             # React + Vite Dashboard
    ├── src/            # UI Components and state management
    └── tailwind.config # Modern styling framework

cd backend
python -m venv venv
.\venv\Scripts\activate    # Windows
source venv/bin/activate   # Mac/Linux
pip install -r requirements.txt

• Copy the example env and add your keys: cp backend/.env.example backend/.env, then edit backend/.env with your OPENROUTER_API_KEY, MONGODB_URI (optional: defaults to localhost), and any other API keys you need.

1. Open Chrome and navigate to chrome://extensions.
2. Enable Developer mode (top right).
3. Click Load unpacked and select the /extension folder.

• Backend: uvicorn main:app --reload --port 8000
• Dashboard: cd webapp && npm install && npm run dev

Kryptos-AI uses a structured "Scout → Analyst → Educator" pipeline to process threats:

1. Scout Agent (First Response):
   • Performs lightweight keyword analysis and URL scanning.
   • Calculates an initial risk score and decides whether to escalate to deep analysis.
2. Analyst Agent (Deep Inspection):
   • Uses LLMs (Gemini 2.0 via OpenRouter) to identify specific threat types.
   • Maps threats to MITRE ATT&CK techniques and gathers evidence.
3. Educator Agent (User Guidance):
   • Translates complex technical analysis into clear, actionable advice.
   • Generates "Next Steps" and defensive learning points for the user.
4. Orchestrator:
   • Manages the data flow between agents.
   • Broadcasts results in real-time to the Webapp using WebSockets.

• API Safety: Never commit your .env file. Ensure OPENROUTER_API_KEY is kept private.
• Privacy: The extension includes Localhost Exceptions to avoid scanning local development environments.
• Screenshot Analysis: Image data is converted to Base64 and processed securely via vision models.

• FastAPI Documentation
• Chrome Extension: Manifest V3 Guide
• OpenRouter Vision API
• Vite + React Quickstart