Installation Documentation

System Requirements

Using uv (Recommended)Using PipUsing Docker

git clone https://github.com/stellarcyber/detection_coverage_app.git
cd detection_coverage_app

uv run coverage-analyzer

or

uv run run.py

or

uv run streamlit run app.py

uv tool install --editable ./

When completed, you can run the app from anywhere in your terminal (not just within the project directory):

coverage-analyzer

or (for headless environments)

coverage-analyzer --headless

git clone https://github.com/stellarcyber/detection_coverage_app.git
cd detection_coverage_app

python3 -m venv .venv
source .venv/bin/activate  # Unix/macOS

or

.venv\Scripts\activate     # Windows

pip install -r requirements.txt

streamlit run app.py

or

python run.py

git clone https://github.com/stellarcyber/detection_coverage_app.git
cd detection_coverage_app

docker build -t coverage_analyzer .

docker run -p 8501:8501 coverage-analyzer

Port Conflicts

# Check port usage
lsof -i :8501      # Unix/macOS
netstat -ano | findstr :8501  # Windows

# Use different port
export STREAMLIT_SERVER_PORT=8502