File size: 1,693 Bytes
27caffe | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 | ---
title: Mindfull AI Wellness Companion
emoji: 🧠
colorFrom: blue
colorTo: slate
sdk: gradio
sdk_version: "5.35.0"
app_file: app.py
pinned: false
license: mit
short_description: Talking-head AI wellness companion. Upload any portrait image.
tags:
- mental-health
- wellness
- avatar
- tts
- talking-head
---
# 🧠 Mindfull – AI Wellness Companion
A talking-head AI wellness chatbot. Upload **any portrait image** as the avatar, type your message, and get a spoken video response.
## How it works
| Step | Component | Notes |
|------|-----------|-------|
| 1 – LLM | Ollama (local) or HF Inference API | `mistralai/Mistral-7B-Instruct-v0.3` on Spaces |
| 2 – TTS | `edge-tts` (Microsoft Neural voices) | No GPU needed |
| 3 – Video | SadTalker + Wav2Lip | GPU Space recommended; tick *Skip video* for audio-only |
## Running locally
```bash
git clone https://huggingface.co/spaces/<your-username>/mindfull
cd mindfull
python -m venv venv && venv\Scripts\activate # Windows
pip install -r requirements_hf.txt
# optionally start Ollama: ollama run mindfull
python app.py
```
## Environment variables (Spaces Secrets)
| Variable | Purpose | Required |
|----------|---------|----------|
| `HF_TOKEN` | HF Inference API token for LLM | Yes (on Spaces) |
| `OLLAMA_MODEL` | Override Ollama model name | No |
## Notes
- Video generation requires SadTalker checkpoints to be present (`sadtalker+wav2lip/sadtalker/checkpoints/`).
On a CPU-only Space, tick **Skip video** to get text + audio responses instantly.
- The trained voice is a fixed neural voice (`en-US-GuyNeural`).
Swapping voices is trivial – change `EDGE_TTS_VOICE` in `simple_audio_gen.py`.
|