🚀 OgonAI Ideal Candidate

OgonAI Ideal Candidate — это система для анализа интервью кандидатов с использованием автоматической транскрипции видео/аудио и анализа речи на основе современных моделей AI.

---

🎯 Цели и задачи Автоматическая транскрибация видео-интервью кандидатов.

• 📊 Оценка кандидатов по нескольким критериям (мотивирующие факторы, локус контроля, активность/пассивность и др.).
• 🤖 Использование AI для генерации количественных и качественных метрик, которые помогают принимать решения.

---

⚙️ Установка и настройка

Для работы с проектом выполните следующие шаги:

1⃣ Клонируйте репозиторий:

git clone git@github.com:MVolobueva/ideal_candidate.git
cd ideal_candidate

---

2⃣ Создайте и активируйте виртуальное окружение:

python3 -m venv venv
source venv/bin/activate   # macOS/Linux
venv\Scripts\activate      # Windows

---

3⃣ Установите зависимости:

pip install -r requirements.txt

---

4⃣ Настройте ключи API:

• Откройте файл main.py.
• Замените значения переменных DEEPGRAM_API_KEY и api_key (openAI) на ваши ключи API.

---

5⃣ Убедитесь, что на вашем устройстве установлен ffmpeg:

• macOS:

  brew install ffmpeg

• Ubuntu:

  sudo apt install ffmpeg

• Windows: Скачайте и установите ffmpeg.

---

🚀 Пример использования

1. Поместите видеофайлы в папку uploads_video/ 🎥.

2. Запустите проект командой:

   python main.py

3. После выполнения вы найдёте:

   • 📜 Расшифровки в папке transcribed_text/.
   • 📊 Результаты анализа в папке outputs/:
     • quantitative_metrics.json — количественные метрики.
     • qualitative_metrics.json — качественные метрики.

---

🗂️ Структура проекта

• uploads_video/ 🎥 — папка для загрузки видеоинтервью кандидатов.
• transcribed_text/ 📜 — папка с результатами транскрибации видео.
• outputs/ 📊 — папка с выходными данными (результатами анализа).
• transcribation/ 🔄 — модуль транскрибации, содержащий:
  • temp/ 🗂️ — временные файлы (например, конвертированные MP3).
  • video_to_text.py 🛠️ — скрипт для конвертации видео и транскрибации.
• prompts.py 💡 — файл с промптами для анализа критериев.
• pydantic_strusture.py ✅ — структура данных для валидации результатов.
• modules.py 📦 — основные модули для анализа текстов и метрик.
• main.py 🚦 — основной скрипт для запуска пайплайна анализа.
• requirements.txt 📋 — список необходимых библиотек для проекта.

---

📋 Требования

• Python 3.8 или выше 🐍
• ffmpeg 🛠️
• API-ключи для:
  • Deepgram 🔑
  • OpenAI 🔐

---

✉️ Контакты

Если у вас есть вопросы или предложения, свяжитесь с нами через GitHub Issues или напишите на email alexanderk9@mail.ru 📧.

---

🎉 Спасибо, что используете OgonAI Ideal Candidate! Удачи в анализе интервью! 🎉