# Psyche Domain Reference

Generated on May 8, 2026. This folder is the uniform Oshun-local documentation
home for the Psyche domain.

## Executive Summary

Psyche creates photorealistic digital humans that join video conferences, hold
real-time conversations, and perform tasks on your behalf. This document
describes every capability available to users of the Psyche platform.

## Documentation Contract

- [Feature Inventory](feature-inventory.md)
- [Implementation Map](implementation-map.md)

## Domain Profile

- Domain slug: `psyche`
- Display name: Psyche
- Aliases: None
- TODO phase coverage: `24`
- TODO phase titles: `Psyche - Hyper-Realistic AI Virtual Assistant Platform`
- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: Referenced in Oshun apps, libraries, or docs.
- Source confidence: Implementation-backed and documentation-backed

## Evidence Profile

| Source                    | Status  | Notes                                  |
| ------------------------- | ------- | -------------------------------------- |
| Repository implementation | present | 157 app/lib/service entries discovered |
| Standalone domain docs    | present | 33 entries under docs/domains/psyche   |
| TODO phase coverage       | present | 1 mapped phase(s), 761 checklist items |
| Tests                     | absent  | 0 matching test files discovered       |
| Oshun integration         | present | 69 Oshun-local references discovered   |

## Capability Pillars

| Capability Pillar                          | Primary Source                  | Status                           |
| ------------------------------------------ | ------------------------------- | -------------------------------- |
| Digital Human Personas                     | docs/domains/psyche/features.md | implementation-backed            |
| Hyper-Realistic Avatar System              | docs/domains/psyche/features.md | implementation-backed            |
| Natural Voice & Speech                     | docs/domains/psyche/features.md | implementation-backed            |
| Real-Time Conversation                     | docs/domains/psyche/features.md | implementation-backed            |
| Knowledge Base & RAG                       | docs/domains/psyche/features.md | implementation-backed            |
| Video Conferencing Integration             | docs/domains/psyche/features.md | implementation-backed            |
| Computer Use & Task Execution              | docs/domains/psyche/features.md | implementation-backed            |
| Emotion & Perception Intelligence          | docs/domains/psyche/features.md | implementation-backed            |
| Memory & Continuity                        | docs/domains/psyche/features.md | implementation-backed            |
| Session Management                         | docs/domains/psyche/features.md | implementation-backed            |
| Admin Dashboard                            | docs/domains/psyche/features.md | implementation-backed            |
| Analytics & Reporting                      | docs/domains/psyche/features.md | implementation-backed            |
| Accessibility                              | docs/domains/psyche/features.md | implementation-backed            |
| Integrations & Webhooks                    | docs/domains/psyche/features.md | implementation-backed            |
| Security & Compliance                      | docs/domains/psyche/features.md | implementation-backed            |
| Plans & Organization Management            | docs/domains/psyche/features.md | implementation-backed            |
| Service Inventory                          | TODOS.md phase 24               | planned-or-partially-implemented |
| Technical Debt Assessment                  | TODOS.md phase 24               | planned-or-partially-implemented |
| Performance Baseline                       | TODOS.md phase 24               | planned-or-partially-implemented |
| Directory Structure Migration              | TODOS.md phase 24               | planned-or-partially-implemented |
| Shared Package Migration                   | TODOS.md phase 24               | planned-or-partially-implemented |
| TypeScript/Python Coexistence              | TODOS.md phase 24               | planned-or-partially-implemented |
| Authentication Integration                 | TODOS.md phase 24               | planned-or-partially-implemented |
| Database Integration                       | TODOS.md phase 24               | planned-or-partially-implemented |
| Caching Integration                        | TODOS.md phase 24               | planned-or-partially-implemented |
| Messaging Integration                      | TODOS.md phase 24               | planned-or-partially-implemented |
| Storage Integration                        | TODOS.md phase 24               | planned-or-partially-implemented |
| Logging & Tracing Integration              | TODOS.md phase 24               | planned-or-partially-implemented |
| Core Avatar Rendering                      | TODOS.md phase 24               | planned-or-partially-implemented |
| Avatar Quality & Performance               | TODOS.md phase 24               | planned-or-partially-implemented |
| Isis Domain Integration for Avatar         | TODOS.md phase 24               | planned-or-partially-implemented |
| Text-to-Speech Pipeline                    | TODOS.md phase 24               | planned-or-partially-implemented |
| Speech-to-Text Pipeline                    | TODOS.md phase 24               | planned-or-partially-implemented |
| Voice Quality                              | TODOS.md phase 24               | planned-or-partially-implemented |
| Facial Expression System                   | TODOS.md phase 24               | planned-or-partially-implemented |
| Body Language                              | TODOS.md phase 24               | planned-or-partially-implemented |
| Behavior Orchestration                     | TODOS.md phase 24               | planned-or-partially-implemented |
| Face Analysis                              | TODOS.md phase 24               | planned-or-partially-implemented |
| Attention & Engagement                     | TODOS.md phase 24               | planned-or-partially-implemented |
| MemGPT-Style Memory Architecture           | TODOS.md phase 24               | planned-or-partially-implemented |
| Memory Operations                          | TODOS.md phase 24               | planned-or-partially-implemented |
| Sophia Domain Integration for Memory       | TODOS.md phase 24               | planned-or-partially-implemented |
| Claude Computer Use Agent                  | TODOS.md phase 24               | planned-or-partially-implemented |
| Sandboxed Execution                        | TODOS.md phase 24               | planned-or-partially-implemented |
| Tool Framework Integration                 | TODOS.md phase 24               | planned-or-partially-implemented |
| Platform Integrations                      | TODOS.md phase 24               | planned-or-partially-implemented |
| Conferencing Quality                       | TODOS.md phase 24               | planned-or-partially-implemented |
| RAG Pipeline                               | TODOS.md phase 24               | planned-or-partially-implemented |
| Sophia Domain Integration for Knowledge    | TODOS.md phase 24               | planned-or-partially-implemented |
| Docker Migration                           | TODOS.md phase 24               | planned-or-partially-implemented |
| Kubernetes Migration                       | TODOS.md phase 24               | planned-or-partially-implemented |
| Terraform Migration                        | TODOS.md phase 24               | planned-or-partially-implemented |
| Python Test Migration                      | TODOS.md phase 24               | planned-or-partially-implemented |
| TypeScript Test Migration                  | TODOS.md phase 24               | planned-or-partially-implemented |
| E2E Testing                                | TODOS.md phase 24               | planned-or-partially-implemented |
| Performance Testing                        | TODOS.md phase 24               | planned-or-partially-implemented |
| CI Pipeline                                | TODOS.md phase 24               | planned-or-partially-implemented |
| CD Pipeline                                | TODOS.md phase 24               | planned-or-partially-implemented |
| Model Management                           | TODOS.md phase 24               | planned-or-partially-implemented |
| Technical Documentation                    | TODOS.md phase 24               | planned-or-partially-implemented |
| Developer Documentation                    | TODOS.md phase 24               | planned-or-partially-implemented |
| User Documentation                         | TODOS.md phase 24               | planned-or-partially-implemented |
| Pre-Launch Checklist                       | TODOS.md phase 24               | planned-or-partially-implemented |
| Launch Monitoring                          | TODOS.md phase 24               | planned-or-partially-implemented |
| Video Conferencing (Remaining Tasks)       | TODOS.md phase 24               | planned-or-partially-implemented |
| Perception Engine (Remaining Tasks)        | TODOS.md phase 24               | planned-or-partially-implemented |
| Accessibility (Remaining Tasks)            | TODOS.md phase 24               | planned-or-partially-implemented |
| Testing & QA (Remaining Tasks)             | TODOS.md phase 24               | planned-or-partially-implemented |
| Deployment & Operations (Remaining Tasks)  | TODOS.md phase 24               | planned-or-partially-implemented |
| Performance Optimization (Remaining Tasks) | TODOS.md phase 24               | planned-or-partially-implemented |
| Mobile SDK                                 | TODOS.md phase 24               | planned-or-partially-implemented |
| White-Label Capabilities                   | TODOS.md phase 24               | planned-or-partially-implemented |
| Edge/Offline Deployment                    | TODOS.md phase 24               | planned-or-partially-implemented |
| Multi-Agent Collaboration                  | TODOS.md phase 24               | planned-or-partially-implemented |
| Proactive Behaviors                        | TODOS.md phase 24               | planned-or-partially-implemented |
| Real-Time Translation                      | TODOS.md phase 24               | planned-or-partially-implemented |
| Human Likeness & Conversation Quality      | TODOS.md phase 24               | planned-or-partially-implemented |
| Technical Metrics                          | TODOS.md phase 24               | planned-or-partially-implemented |
| Tavus API Infrastructure                   | TODOS.md phase 24               | planned-or-partially-implemented |
| Phoenix Rendering Integration              | TODOS.md phase 24               | planned-or-partially-implemented |
| Sparrow Turn-Taking Integration            | TODOS.md phase 24               | planned-or-partially-implemented |
| Raven Perception Integration               | TODOS.md phase 24               | planned-or-partially-implemented |
| Tavus CVI Pipeline Integration             | TODOS.md phase 24               | planned-or-partially-implemented |
| Video Conferencing Bridge for Tavus        | TODOS.md phase 24               | planned-or-partially-implemented |
| Tavus Memories & Context                   | TODOS.md phase 24               | planned-or-partially-implemented |
| Tavus Knowledge Base Integration           | TODOS.md phase 24               | planned-or-partially-implemented |
| Tavus Objectives & Guardrails              | TODOS.md phase 24               | planned-or-partially-implemented |
| Tavus Tool Calling Integration             | TODOS.md phase 24               | planned-or-partially-implemented |
| Hybrid Mode (Psyche + Tavus)               | TODOS.md phase 24               | planned-or-partially-implemented |
| Pipecat Framework Integration              | TODOS.md phase 24               | planned-or-partially-implemented |

## Coverage Snapshot

- Code footprint entries: 157
- Standalone domain doc entries: 33
- OpenAPI/API doc entries: 0
- Test evidence files: 0
- Oshun-specific references: 69

## Source Precedence

1. Actual repository implementation under `apps/`, `libs/`, `services/`, and
   `openapi/`
2. Checklist-derived scope from `TODOS.md`
3. Existing standalone domain docs under `docs/domains/psyche/`
4. No feature claims are introduced without one of the sources above
