CLAUDE.md

AnkiGen Development Notes

Dependency Management

This project uses pyproject.toml for direct dependencies (floor pins like >=) and requirements.txt for the full frozen lockfile (exact pins with ==). Both must stay in sync.

Gradio + HuggingFace Spaces

The app is deployed as a Gradio Space on HuggingFace. The README.md YAML frontmatter contains sdk_version: which must match the pinned gradio version in requirements.txt. If these drift, the Space will either fail to build or run a different gradio version than what was tested locally.

When bumping gradio:

1. Update requirements.txt (gradio==X.Y.Z)
2. Update pyproject.toml (gradio>=X.Y.Z)
3. Update README.md frontmatter (sdk_version: X.Y.Z)
4. Also bump gradio-client in requirements.txt to the matching release