README.md

---
title: Hanbridge Clare Assistant (Product UI)
emoji: 💬
colorFrom: yellow
colorTo: purple
sdk: docker
pinned: false
license: mit
---

# Hanbridge Clare Assistant – Product Version

This Space hosts **Clare**, an AI-powered personalized learning assistant for Hanbridge University.

## Architecture Overview

- **Frontend**: React + Vite (exported from Figma design)
- **Backend**: FastAPI (Python)
- **LLM Orchestration**: OpenAI + LangChain
- **Observability**: LangSmith
- **Deployment**: Hugging Face Docker Space

### Optional: Text-to-Speech & Podcast

- **TTS**: Uses the same **OpenAI API key** (no extra secrets). Convert export/summary text to speech.
- **Podcast**: Generates an MP3 from the session summary or full conversation.
- **Hugging Face**: Set `OPENAI_API_KEY` in the Space **Settings → Secrets**. No extra env vars needed.



```
📦 project/
 ├── app.py
 ├── api/
 │   ├── server.py
 │   ├── clare_core.py
 │   ├── rag_engine.py   ← RAG
 │   └── tts_podcast.py  ← TTS & podcast (OpenAI TTS)
 └── requirements.txt

```