python3 -m pip install -e .[dev]Run the unit test suite before opening a pull request:
python3 -m pytest -q
python3 -m buildLive generation tests are optional and require Higgsfield credentials:
export HF_KEY="your-key:your-secret"Or use split credentials:
export HF_API_KEY="your-key"
export HF_API_SECRET="your-secret"Then run:
python3 examples/simple_generate.py- Keep changes focused.
- Add or update tests when behavior changes.
- Update docs when the public API or workflow changes.
- Do not commit generated assets, local credentials, or cache files.
- Prefer small, reviewable diffs over broad refactors.