Getting Started with AEGIS

Prerequisites

Hardware Requirements

• CPU: 4+ cores (8+ recommended for multi-stream)
• RAM: 8GB minimum (16GB+ recommended for 8 streams)
• Storage: 20GB (for GGUF models and database)
• Network: Gigabit Ethernet (for RTSP streaming)

Software Requirements

• Python: 3.11 or higher
• Node.js: 18 or higher
• llama.cpp: Latest version with server support

Installation

1. Clone Repository

git clone <repository-url>
                cd AEGIS2

2. Backend Setup

cd backend
                pip install -r requirements.txt

3. Install llama.cpp and Models

# Install llama.cpp server
                # Download from https://github.com/ggerganov/llama.cpp/releases

                # Start llama.cpp server with Ministral-3 model
                llama-server -hf mistralai/Ministral-3-8B-Instruct-2512-GGUF:Q4_K_M --port 8080 -ngl 99

4. Frontend Setup

cd ..
                npm install

Running the Application

Start Backend Server

python backend/server.py
                # Server starts at http://localhost:8000

Start Frontend Development Server

npm run dev
                # Frontend available at http://localhost:5173

Usage Guide

1. Navigate to Multi-Stream Tab: Click "Multi-Stream CCTV" in the top navigation.

2. Add a Stream: Click "+ Add Stream" and fill in details (RTSP URL, Webcam Index, or File).

3. View Live Streams: Monitor up to 8 streams simultaneously in the grid view.