ad-nix/README.md

NixOS Configuration for AppDaemon Development

Objectives

• Use flakes
• devenv-based workflow
  • Shell
    • Makes uv available
    • Syncs devenv virtual environment
    • appdaemon
  • Build Docker
• SSH remote with VSCode
• Jupyter through VSCode
  • autoreload must work with editable install of the dev version
• Multiple dev versions
• Multiple config directories
• Debugger must work

Usage

nfs

Used to rebuild the ad-nix system with whatever is currently symlinked to /etc/nixos

ads

Used to enter the development shell. Be careful, as this will create a .devenv directory and venv wherever it's entered.

venv

Activated with .devenv/state/venv/bin/activate. Used in VSCode for type hints, running, and debugging

Jupyter

• Install devenv kernel - might not be useful?
  • python -m ipykernel install --user --name devenv --display-name "Python (devenv)"
• Run jupyter notebook on the side with a uv run jupyter notebook command
• Use the link with the token to connect the jupyter notebook kernel to it