README.md

---
title: Raven AI
emoji: 🐦‍⬛
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: true
license: mit
models:
  - Fynman-stack/raven-emotion-distilbert
short_description: Emotionally aware AI with DistilBERT emotion detection
---

# Raven AI — Emotionally Aware AI Assistant

Raven AI is a full-featured, emotionally aware AI assistant that combines a fine-tuned DistilBERT emotion classification model with large language models to deliver emotionally adaptive responses.

## Features

- **Emotion Detection** — Fine-tuned DistilBERT (97.62% accuracy) classifies 6 emotions: happy, sad, anxious, angry, confused, neutral
- **9 Intent Types** — venting, question, advice, casual, crisis, coding, learning, creative, deep_dive
- **Crisis Detection** — 55 keyword phrases with automatic helpline provision
- **Image Understanding** — Up to 5 images via Llama 4 Scout
- **Voice Input** — Whisper Large V3 Turbo transcription with editable preview
- **Document Processing** — PDF, TXT, code files with 7 processing actions
- **Web Search** — DuckDuckGo integration for real-time information
- **Multi-Chat Management** — Create, switch, delete, export conversations
- **Dynamic Temperature** — Per-intent creativity tuning
- **Emotion Smoothing** — Prevents jarring emotional transitions

## Model

Uses [Fynman-stack/raven-emotion-distilbert](https://huggingface.co/Fynman-stack/raven-emotion-distilbert) — a 67M parameter DistilBERT that outperforms a 70B LLM by +4.33% on emotion classification.

## Links

- **Model**: [Fynman-stack/raven-emotion-distilbert](https://huggingface.co/Fynman-stack/raven-emotion-distilbert)
- **GitHub**: [github.com/Fynman-stack/raven-ai](https://github.com/Fynman-stack/raven-ai)
- **Streamlit Cloud**: [raven-ai-new.streamlit.app](https://raven-ai-new.streamlit.app)