# Overview: How therappai works

therappai provides a set of AI-powered mental-wellbeing features through a simple REST API. This overview explains the core systems behind the platform so you understand how everything fits together before integrating individual endpoints.

The platform is built around a few key components: **users**, **AI therapy sessions**, **content**, **mood tracking**, and **safety tools**. Each component can be used independently or combined to create a complete wellbeing experience in your product.

***

### **1. Users**

Every interaction begins with a user account.\
After a user signs up or logs in, the API issues an access token that your application uses to make requests on their behalf.

#### Users can:

* authenticate
* update profile data
* store personal wellbeing settings
* access content and therapy sessions

User identity is tied directly to session history, moods, tasks, and emergency contacts.

***

### **2. AI Therapy Sessions**

therappai offers three types of AI-powered support:

#### **Chat therapy**

Users send messages, and the AI therapist replies with guidance, reflection, or emotional support.

#### **Voice therapy**

Users send audio messages for a more natural conversation style (optional).

#### **Video therapy (AI avatar)**

A video-based interaction where an AI avatar speaks the response generated by the therapy engine.

#### Session flow (for all modes)

1. User sends a message (text or audio)
2. therappai processes context, tone, and safety signals
3. An AI therapist response is generated
4. Optional: response delivered as audio or video

Sessions are **stateless** per call — your app can store or display history however you prefer.

***

### **3. Content Library (CBT, DBT, Mindfulness)**

therappai includes a growing library of structured mental-health content:

* CBT exercises
* DBT skills
* Mindfulness practices
* Grounding tools
* Short wellbeing routines

Your application can fetch content lists, individual exercises, transcripts, and progress for each user.

This allows you to build educational or therapeutic flows alongside AI sessions.

***

### **4. Mood Tracking & Insights**

Users can record their daily mood using a simple scale and optional notes.\
The API stores each entry and allows your application to:

* list past mood logs
* view trends over time
* surface insights and patterns
* build dashboards or wellbeing summaries

Mood tracking can be integrated into daily check-ins, routines, or onboarding flows.

***

### **5. Daily Tasks & Routines**

therappai generates lightweight wellbeing tasks to help users build habits and improve resilience.

Your app can:

* fetch daily tasks
* display them in your UI
* mark them as completed

This system is designed to be simple for v1 and easy to extend in future releases.

***

### **6. Crisis Buddy & Safety**

Users can store trusted contacts for safety purposes.

#### Crisis Buddy enables:

* saving emergency contacts
* retrieving contact details
* updating or removing contacts

Your app chooses how to use this information (e.g., display it, link to dialer, provide quick access in stressful moments).

> **Note:** therappai does not contact emergency services.\
> It is a user-controlled safety feature, not an automated alert system (v1).

***

### **Putting It All Together**

A typical therappai-powered workflow looks like:

1. User signs up
2. User logs in and receives tokens
3. User starts a therapy session (chat/voice/video)
4. User accesses CBT/DBT content
5. User logs mood entries
6. User completes daily tasks
7. User stores emergency contacts

Each part is independent — you can integrate one feature or all of them.