alice

Docker

python3 builder.py --no-venv

The builder generates docker-compose.yml automatically, depending on your configured hardware (GPU or CPU). Edit the volume paths to match your Frigate setup, then:

docker compose up --build -d

See Docker Setup below for details.

---

Requirements

Python 3.8+ required. The builder creates a .venv and installs the base dependency (Pillow) automatically. All other dependencies are managed by ALICE and can be installed from the welcome page or Settings → System with one click:

Package	Purpose
Pillow	Image processing, pHash, format conversion (auto-installed by builder)
NumPy	Numerical operations for dedup
inotify	Filesystem watching on Linux (falls back to polling)
opencv-python-headless	Video frame extraction
ONNX	ONNX model format for export
onnxslim	ONNX model optimization
onnxruntime	ONNX Runtime — GPU or CPU variant auto-selected
PyTorch	Deep learning framework — CUDA or CPU variant auto-selected
ultralytics	YOLO model training & inference

ALICE installs the correct PyTorch variant (CUDA or CPU) based on detected hardware. No manual torch installation needed.

Note: ALICE does not install NVIDIA drivers or CUDA. If you want GPU-accelerated training, install the NVIDIA drivers and CUDA toolkit on your system before running ALICE.

---

Docker Setup

The builder generates docker-compose.yml with GPU support auto-detected from your host:

python3 builder.py --no-venv

This creates docker-compose.yml with the NVIDIA GPU block included if a GPU is detected, or CPU-only otherwise.

Edit the volume paths to match your setup:

volumes:
  - ./alice.conf:/app/alice.conf
  - /path/to/datasets:/app/datasets
  - /path/to/models:/app/models
  - /path/to/frigate/clips:/app/clips:ro
  - /path/to/frigate/exports:/app/exports:ro
  - /path/to/frigate/frigate.db:/app/frigate.db:ro

Important: The frigate.db volume must point to the actual file, not a directory. If the file doesn't exist on the host at the time of container creation, Docker will create a directory instead and ALICE won't be able to open the database.

Then start:

docker compose up --build -d

On first run, open ALICE in your browser and install dependencies from the welcome page or Settings → System. Dependencies are persisted in a Docker volume across container restarts.

Note: GPU support in Docker requires NVIDIA Container Toolkit on the host. If running the builder on a machine without GPU, the generated compose file will be CPU-only.

---

License

PolyForm Noncommercial 1.0.0 — free for personal, non-commercial use. For commercial licensing, contact alice@it-link.net.