Нить — AI-агент для поиска своего человека

Telegram Mini App · AI-матчинг через разговор, не через свайпы

О проекте

Нить — это не dating app. Это AI-агент, который помогает найти своего человека через разговор.

Пользователь рассказывает о себе голосом или текстом. AI понимает кто этот человек, строит психологический профиль и находит совместимых людей через семантический поиск — объясняя конкретно почему они подходят.

Обычное приложение	Нить
Свайпы по фото	Разговор с AI
Заполнение анкеты	Свободный рассказ голосом/текстом
Оценка по внешности	Совместимость по психологии и ценностям
Нет объяснений	AI объясняет почему подходят

Стек

Backend:

• Python 3.11 · FastAPI · aiogram v3
• PostgreSQL + pgvector (семантический поиск совместимости)
• Redis (кеш сессий и очередей)
• ARQ (async job workers: генерация эмбеддингов, матчинг)
• OpenAI API: GPT-4o (диалог + построение профиля) + Whisper (голосовой ввод)
• NudeNet (модерация фотографий)

Frontend:

• React + TypeScript (Telegram WebApp / Mini App)
• CSS Modules

Инфраструктура:

• Docker + Docker Compose
• Dockerfile для backend и frontend

Архитектура

Telegram Mini App (React/TS)
        │
        ▼
FastAPI Backend ──── aiogram v3 (Telegram Bot)
        │
   PostgreSQL
   + pgvector ──── ARQ Workers (async)
        │               │
      Redis         OpenAI API
                   (GPT-4o + Whisper)

Ключевые функции

• Голосовой и текстовый онбординг — Whisper транскрибирует голос, GPT-4o извлекает данные о пользователе
• AI-психологический профиль — агент задаёт адаптивные уточняющие вопросы (не анкету), строит профиль личности
• Семантический матчинг — pgvector + эмбеддинги OpenAI, до 5 матчей в день
• Матч-чат — 48-часовое окно общения внутри приложения, обмен контактами только при двустороннем согласии
• Постдейт рефлексия — AI спрашивает результат встречи через 48 часов
• Фото-модерация — NudeNet async воркер

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

git clone https://github.com/korkinolegip/nit-app.git
cd nit-app
cp .env.example .env
# Заполнить: OPENAI_API_KEY, TELEGRAM_BOT_TOKEN, DATABASE_URL
docker-compose up --build

Переменные окружения

Переменная	Описание
OPENAI_API_KEY	API ключ OpenAI (GPT-4o + Whisper)
TELEGRAM_BOT_TOKEN	Токен бота от @BotFather
DATABASE_URL	PostgreSQL connection string
REDIS_URL	Redis connection string

Автор

Олег Коркин · github.com/korkinolegip

Python AI-разработчик | Разработка велась с использованием Claude Code + Cursor AI