# Digital Soul Morphing

> Digital Soul Morphing превращает одно фото пользователя в короткое (5–7 секунд) морфинг-видео, где лицо плавно трансформируется. После генерации запускается короткий чат: «How can I help you?» — для понимания намерений пользователей. Backend на FastAPI + Kling AI для генерации.

## Quick Links

- [Main site (EN)](https://dsdigitalsoul.com/): описание продукта на главном сайте
- [Main site (RU)](https://dsdigitalsoul.com/ru): то же на русском
- [Launcher](https://morphing.dsdigitalsoul.com/): главная страница — 6 кнопок-входов в навыки Digital Soul
- [Soul chat](https://morphing.dsdigitalsoul.com/chat): открытый разговор с цифровой Душой (skill-routing через function-calling)
- [Music DNA](https://morphing.dsdigitalsoul.com/audio-dna): расшифровать музыкальный вкус, получить паспорт
- [Music Recommend](https://morphing.dsdigitalsoul.com/audio-recommend): получить 10 anchored рекомендаций музыки
- [Video Recommend](https://morphing.dsdigitalsoul.com/video-recommend): получить 10 anchored рекомендаций фильмов/сериалов/аниме
- [Morphing widget](https://morphing.dsdigitalsoul.com/widget): встраиваемая страница которая запускает камеру и генерит видео
- [Privacy policy](https://morphing.dsdigitalsoul.com/privacy): обработка данных

## Public API

- `POST /api/morphing/start` — загрузка фото, старт генерации, возвращает `job_id`
- `GET /api/status/{job_id}` — статус генерации
- `POST /api/chat` — пост-морфинг чат widget'а (legacy Stage A), payload `{session_id, message, morphing_job_id?}`
- `POST /api/soul/chat` — мульти-turn Soul-chat для `/chat` страницы, payload `{messages, lang}`, поддерживает function-calling на навыки
- `GET /api/skills` — каталог доступных skill'ов (music-dna, music-recommend, video-recommend)
- `POST /api/skills/{slug}/run` — запустить skill напрямую, без чата
- `POST /api/share/{job_id}` — пользователь поделился результатом
- `POST /api/feedback/{job_id}` — обратная связь

## How it works

1. Юзер открывает /widget с разрешением камеры
2. Делает или загружает фото
3. Backend через Kling AI генерит 5-7 сек морфинг видео (~30-60 сек)
4. После просмотра — чат на основе Claude Haiku 4.5

## Tech stack

- FastAPI (Python 3.12)
- Kling AI (fal.ai)
- Three.js frontend
- SQLite для аналитики
- Yandex.Metrika + Google Analytics для traffic