KyrilosKamal/SecAppliance

SecAppliance must run inside a virtual environment. It is not optional:

• The host Python is usually externally managed (PEP 668 on Debian/Ubuntu, and pip is often absent entirely), so a global pip install fails or is refused.
• requirements.txt pins exact versions; installing those over your system packages can break other tools on the machine.
• The pinned set requires Python 3.11+, which may differ from the system default.

Every python main.py command further down assumes the environment below is active. If you prefer not to activate it, call the interpreter directly: .venv/bin/python main.py ... (Windows: .venv\Scripts\python main.py ...).

1. Clone the repository:

   git clone https://github.com/KyrilosKamal/SecAppliance.git
   cd SecAppliance
   

2. Create and activate a virtual environment:

   # Linux / macOS
   python3 -m venv .venv
   source .venv/bin/activate
   
   # Windows (Command Prompt)
   python -m venv .venv
   .venv\Scripts\activate
   
   # Windows (PowerShell)
   python -m venv .venv
   .\.venv\Scripts\Activate.ps1
   
   # Verify you are inside the environment before continuing:
   python -c "import sys; print(sys.prefix)"
   

3. Install dependencies:

   pip install --upgrade pip
   pip install -r requirements.txt
   

   (All dependencies are strictly pinned for reproducible builds. To upgrade, test, and re-pin deliberately).