README.md

---
title: Codettes-BlackForest
emoji: 🧠
colorFrom: gray
colorTo: purple
sdk: gradio
sdk_version: 5.25.2
app_file: final_codettes_chatbot.py
pinned: true
license: mit
---

# 💬 Codettes-BlackForest: Multimodal Reasoning Chatbot

An advanced multimodal chatbot powered by [Gradio](https://gradio.app), [`transformers`](https://huggingface.co/docs/transformers), and [`diffusers`](https://huggingface.co/docs/diffusers), featuring:

- 🔍 Sentiment analysis
- 🧠 Reasoning across multiple LLM pipelines
- 🎨 Text-to-image generation using the gated model [`black-forest-labs/FLUX.1-dev`](https://huggingface.co/black-forest-labs/FLUX.1-dev)

## 🚀 Features
- Context-aware response generation using T5, GPT-Neo, and DistilBERT
- Emotional and ethical sentiment scoring with VADER and transformers
- Image synthesis via FLUX 1.0-dev diffusion model
- Supports GPU or CPU fallback via PyTorch offload
- Simple, async-capable chat interface with modular blocks

## 🔐 Gated Model Access

This Space requires a valid `HUGGINGFACE_TOKEN` with access to `black-forest-labs/FLUX.1-dev`.

Add this under **Repository Secrets**:
```
HUGGINGFACE_TOKEN = your_token_here
```

## 🛠 Requirements

See [`requirements.txt`](./requirements.txt) for full dependencies. Main libraries include:

- `transformers`
- `diffusers`
- `torch`
- `gradio`
- `huggingface_hub`
- `vaderSentiment`
- `nltk`

## 📄 License

MIT License (c) 2025 Jonathan Harrison / Raiff's Bits LLC