Интеллектуальный AI-ассистент с поддержкой голосовых сообщений, транскрибации аудио/видео файлов и обработки текстовых документов.
- Умный чат с AI - общение с AI на базе OpenAI GPT-3.5-turbo
- Голосовые сообщения - запись аудио и получение ответов в виде голосовых сообщений
- Транскрибация файлов - автоматическая транскрибация аудио и видео файлов через OpenAI Whisper
- Обработка документов - чтение и анализ текстовых файлов (txt, md, code files)
- Выбор голоса - 6 различных голосов для озвучки ответов AI
- Современный UI - адаптивный дизайн с поддержкой мобильных устройств
- История чата - сохранение истории сообщений в localStorage
- Next.js 16 - React фреймворк для production
- React 19 - библиотека для построения пользовательских интерфейсов
- TypeScript - типизированный JavaScript
- Tailwind CSS - utility-first CSS фреймворк
- Zustand - легковесное управление состоянием
- OpenAI API - интеграция с GPT и Whisper
- React Icons - библиотека иконок
- Node.js 18+
- Yarn
- OpenAI API ключ
git clone <repository-url>
cd hackathon-clientyarn installСоздайте файл .env.local в корне проекта:
OPENAI_API_KEY=your_openai_api_key_hereГде получить API ключ:
- Перейдите на OpenAI Platform
- Зарегистрируйтесь или войдите в аккаунт
- Перейдите в раздел API Keys
- Создайте новый API ключ
- Скопируйте ключ и вставьте в
.env.local
.env.local в репозиторий!
Запуск development сервера:
yarn devОткройте http://localhost:3000 в браузере.
hackathon-client/
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── api/ # API routes
│ │ │ ├── openai/ # OpenAI chat completions
│ │ │ ├── tts/ # Text-to-Speech API
│ │ │ └── transcribe/ # Audio transcription
│ │ ├── chat/ # Страница чата
│ │ ├── about/ # Страница "О нас"
│ │ └── page.tsx # Главная страница
│ ├── components/ # React компоненты
│ │ ├── AudioMessage/ # Компонент аудио сообщений
│ │ ├── ChatInput/ # Компонент ввода сообщений
│ │ ├── ChatMessages/ # Компонент отображения сообщений
│ │ ├── ExtraOptions/ # Дополнительные опции (файлы, озвучка)
│ │ └── Header/ # Компонент шапки сайта
│ ├── features/ # Бизнес-логика
│ │ └── data.ts # Работа с localStorage и API
│ ├── store/ # State management
│ │ └── useChatStore.ts # Zustand store для чата
│ └── types/ # TypeScript типы
├── .env.local # Переменные окружения (создать вручную)
├── package.json
├── tailwind.config.js
└── tsconfig.json
- Перейдите на страницу
/chat - Введите сообщение в поле ввода
- Нажмите кнопку отправки или Enter
- Получите ответ от AI
- Нажмите кнопку "+" рядом с полем ввода
- Выберите файл (текстовый, аудио или видео)
- Файл будет автоматически обработан:
- Аудио/Видео - транскрибировано через Whisper
- Текстовые файлы - прочитано содержимое
- AI получит содержимое файла и сможет ответить на вопросы о нем
- Нажмите кнопку с иконкой волны для записи аудио
- Запишите сообщение
- Остановите запись
- Аудио будет автоматически добавлено к сообщению
- Перед отправкой сообщения нажмите кнопку "+"
- Включите опцию "Включить озвучку"
- Отправьте сообщение
- Ответ AI будет озвучен и отображен как аудио сообщение
- Можно выбрать голос для озвучки через настройки (шестеренка)
- На странице чата нажмите кнопку "Очистить чат"
- Подтвердите действие
- История сообщений будет удалена
yarn buildЗапуск production сервера:
yarn start- Метод: POST
- Описание: Отправка сообщений в OpenAI Chat API
- Параметры:
messages(JSON string) - массив сообщенийfiles(File[]) - файлы для обработки
- Метод: POST
- Описание: Генерация аудио из текста через OpenAI TTS
- Параметры:
text(string) - текст для озвучкиvoice(string) - выбор голоса (alloy, echo, fable, onyx, nova, shimmer)
- Метод: POST
- Описание: Транскрибация аудио/видео файлов
- Параметры:
file(File) - аудио или видео файл
- API ключ OpenAI хранится только на сервере в переменных окружения
- Никогда не передавайте API ключ на клиент
- Используйте
.env.localдля локальной разработки - Для production используйте переменные окружения вашего хостинга
- Убедитесь, что файл
.env.localсоздан в корне проекта - Проверьте, что переменная
OPENAI_API_KEYуказана правильно - Перезапустите development сервер после создания
.env.local
- Проверьте, что браузер поддерживает Web Speech API
- Убедитесь, что микрофон доступен для записи
- Проверьте разрешения браузера для доступа к микрофону
- Убедитесь, что файл не превышает лимиты OpenAI API
- Проверьте формат файла (поддерживаются: аудио, видео, текстовые файлы)
- Проверьте консоль браузера на наличие ошибок
Этот проект создан для хакатона.
Приятного использования! 🚀