89 lines
2.5 KiB
Markdown
89 lines
2.5 KiB
Markdown
# 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
|