CLAUDE.md

# CatLLM HuggingFace Space

## Deployment

Push to: https://huggingface.co/spaces/CatLLM/survey-classifier

## Authentication

HuggingFace token is stored in `.env` in this directory:
- Variable: `CATLLM_HF_TOKEN`
- Used for pushing to the CatLLM organization space

## Architecture

The HuggingFace app should always use the `catllm` Python package for core functions (classification, extraction, etc.). Do not duplicate catllm logic in the app—import and call `catllm.classify()` and `catllm.extract()` directly. If new functionality is needed (e.g., progress callbacks), add it to the catllm package first, then use it in the app.