| | --- |
| | title: CatVader - Social Media Classifier |
| | emoji: 🐱 |
| | colorFrom: yellow |
| | colorTo: yellow |
| | sdk: streamlit |
| | sdk_version: "1.32.0" |
| | app_file: app.py |
| | pinned: false |
| | license: mit |
| | short_description: Classify social media posts using LLMs |
| | --- |
| | |
| | # CatVader - Social Media Classifier |
| |
|
| | A web interface for the [cat-vader](https://github.com/chrissoria/cat-vader) Python package. Classify social media posts into custom categories using various LLM providers. |
| |
|
| | ## How to Use |
| |
|
| | 1. **Upload Your Data**: Upload a CSV or Excel file containing social media posts |
| | 2. **Select Column**: Choose the column containing the text to classify |
| | 3. **Define Categories**: Enter your classification categories (e.g., "Positive", "Negative", "Neutral") |
| | 4. **Choose a Model**: Select your preferred LLM (free models available!) |
| | 5. **Click Classify**: View and download results with category assignments |
| |
|
| | ## Supported Models |
| |
|
| | | Provider | Models | |
| | |----------|--------| |
| | | **OpenAI** | gpt-4o, gpt-4o-mini | |
| | | **Anthropic** | Claude Sonnet, Claude Haiku | |
| | | **Google** | Gemini 2.5 Flash, Gemini 2.5 Pro | |
| | | **Mistral** | Mistral Large, Mistral Small | |
| | | **xAI** | Grok models | |
| | | **HuggingFace** | Qwen, Llama 4, DeepSeek, and thousands more | |
| |
|
| | ## Features |
| |
|
| | - **Multi-label classification**: Assign multiple categories per post |
| | - **Social media context**: Inject platform, handle, and hashtag context into prompts |
| | - **Image classification**: Classify posts with images or image URL columns |
| | - **Multi-model ensemble**: Run multiple models and use majority voting |
| | - **Batch processing**: Handle thousands of posts efficiently |
| | - **CSV/Excel export**: Download results ready for analysis |
| |
|
