# Pleep24 — AI Sales Agent

Self-hosted аналог [Pleep.app](https://pleep.app/) — мультиканальный AI-агент продаж.

## Что это

Pleep24 закрывает полный цикл сделки: от первого сообщения клиента до оплаты — через Telegram, WhatsApp, Instagram, веб-чат и телефонные звонки.

**Ключевое отличие от Pleep:** вместо встроенного CRM используется [Twenty CRM](https://twenty.com) (open-source, self-hosted). Голос — через [calls24](https://t.me/calls24).

## Архитектура

```
Telegram / WhatsApp / Instagram / Web Chat / Voice
          │
          ▼
   Message Router (FastAPI :8100)    ← сессии, каналы
          │
          ▼
   AI Brain (FastAPI :8101)          ← LLM + RAG + tools
          │
          ▼
   Twenty Gateway (FastAPI :8102)    ← Twenty CRM API + платежи
          │
          ▼
   Twenty CRM + Qdrant (KB)
```

## Стек

| Компонент | Технология |
|-----------|-----------|
| Backend | Python 3.12, FastAPI, asyncpg |
| LLM | DeepSeek (primary), Ollama (fallback) |
| RAG | Qdrant + embedding-модель |
| CRM | Twenty (self-hosted) |
| Voice | calls24 + Yandex AI Realtime API |
| TTS | Silero TTS |
| DB | PostgreSQL 16 |
| Cache | Redis (опционально) |
| Channels | Telegram (MAX API), WhatsApp, Instagram, Web Widget |
| Deploy | Coolify + Docker Compose |

## Быстрый старт

```bash
# 1. Клонировать
git clone http://192.168.1.230:3333/neo/pleep24.git
cd pleep24

# 2. Настроить окружение
cp .env.example .env
# Заполнить: DEEPSEEK_API_KEY, TWENTY_API_KEY, TELEGRAM_BOT_TOKEN, etc.

# 3. Запустить
docker compose up -d

# 4. Загрузить базу знаний
python scripts/load_kb.py --dir kb/
```

## Сервисы

| Порт | Сервис |
|------|--------|
| 8100 | Message Router |
| 8101 | AI Brain |
| 8102 | Twenty Gateway |

## Документация

- [ARCHITECTURE.md](ARCHITECTURE.md) — полная архитектура
- [API.md](docs/API.md) — API-спецификация
- [DEPLOY.md](docs/DEPLOY.md) — инструкция по деплою

## Roadmap

- [x] Архитектура
- [ ] Twenty Gateway (CRUD для Person, Deal, Note)
- [ ] AI Brain (LLM + Qdrant RAG)
- [ ] Message Router (Telegram)
- [ ] Web Widget
- [ ] Voice integration (calls24 → Twenty)
- [ ] WhatsApp-канал

## Лицензия

MIT