# Clone the repository
git clone https://github.com/yourusername/PyAI-Slayer.git
cd PyAI-Slayer

# Install system dependencies (Linux/Ubuntu)
sudo apt-get update && sudo apt-get install -y git wget gnupg fonts-liberation libasound2 \
    libatk-bridge2.0-0 libatk1.0-0 libcups2 libdbus-1-3 libdrm2 libgbm1 libgtk-3-0 \
    libnspr4 libnss3 libxcomposite1 libxdamage1 libxfixes3 libxkbcommon0 libxrandr2

# Setup (installs dependencies & browsers)
make setup

# Configure environment
cp .env.example .env
# Edit .env with your settings (CHATBOT_URL, etc.)

# Run all e2e tests (AI, security, UI)
make test

# Run specific test categories
make test-ai          # AI validation tests only
make test-security   # Security tests only
make test-ui         # UI tests only
make test-unit       # Unit tests only

# Run all tests (unit + e2e)
make test-all

# Run with coverage
make test-cov

make dashboard
# Access at http://localhost:8080

# Create your eval set (see docs/RAG_CALIBRATION_USAGE.md)
cp data/examples/example_rag_eval_set.json data/rag_eval_set.json
# Edit with your queries and labeled chunks

# Run calibration
python scripts/calibrate_rag_metrics.py

# Dashboard automatically uses calibrated targets

# Setup & Installation
make setup              # Complete project setup (check Python, create venv, install deps)
make install-dev        # Install package with dev dependencies (auto-detects GPU)
make install-hooks      # Install pre-commit hooks
make playwright-install # Install Playwright browsers

# Testing
make test               # Run all e2e tests (AI, security, UI - excludes unit tests)
make test-all           # Run all tests (unit + e2e)
make test-unit          # Run unit tests only
make test-unit-cov      # Run unit tests with coverage report
make test-ai            # Run AI tests only
make test-security      # Run security tests only
make test-ui            # Run UI tests only
make test-integration   # Run integration tests only
make test-property      # Run property-based tests (Hypothesis)
make test-cov           # Run all tests with coverage report

# Code Quality
make lint               # Run linter (ruff)
make format             # Format code (ruff format only)
make format-check       # Check code formatting without modifying files
make type-check         # Run type checker (mypy)
make check              # Run all checks (lint + type-check)
make pre-commit         # Run all pre-commit checks (format + lint + type-check + security)
make security-scan      # Run security scan (bandit)

# Build & CI
make build              # Build distribution packages
make ci                 # Run CI pipeline (install-dev + lint + type-check + test-unit)

# Documentation
make docs               # Build Sphinx documentation
make docs-serve         # Build and serve documentation at http://localhost:8000

# Dashboard & Metrics
make dashboard          # Start metrics dashboard server
make dashboard-custom   # Start dashboard with custom port
make metrics-summary    # View test metrics summary (requires metrics enabled)
make metrics-export     # Export metrics to JSON file
make metrics-raw        # View raw metrics data

# Cleanup
make clean              # Remove venv, build artifacts, caches

For a complete list of all available commands, run `make help`.

# Build and run
make docker-build
make docker-test

# Or use docker-compose
docker-compose up --build

# Setup development environment
make setup

# Run tests before committing
make check
make test

# Format code
make format