Recommend setting up on Linux, macOS, or WSL. Windows can be problematic. Below assumes some basic installs (python, pip, venv, node, npm, pyenv)
git clone <black-rod repo>
cd black-rodFor Ubuntu/Debian-based systems:
sudo apt update && sudo apt install -y sqlite3For macOS using Homebrew:
brew install sqliteFor Windows: Download the installer from SQLite Downloads and follow the instructions.
Install pyenv if you haven't already, or install the version of python listed in .python-version and verify its being used in your repo
Make sure to use python3 for the virtual environment:
python -m venv venv
source venv/bin/activate
pip install --upgrade pip setuptools wheel -c constraints.txt
pip install -r requirements.txt -c constraints.txtnvm install
nvm use
npm ci
npm run buildpython manage.py -d makemigrations
python manage.py -d migrate
python3 manage.py -d loaddata dev_fixturespython manage.py makesuperuser./bin/dev-serverThe versioned black-rod task skill provides isolated worktree setup, private SQLite development/test databases, dev servers, desktop/mobile screenshots, PR image links, and detached GitHub Actions notifications. Start with AGENTS.md. Codex and Claude share the same checked-in skill; no user-level skill installation is required.