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.