ИИ-тьютор по математике для подготовки к ЕГЭ

Этот проект представляет собой ИИ-агента на базе LlamaIndex, который выполняет роль тьютора по математике для подготовки к ЕГЭ. Агент учитывает специфику экзамена и не дает прямых ответов на задачи, а направляет пользователя к правильному решению.

Особенности

• Учет специфики ЕГЭ: Агент знает структуру экзамена, типы заданий и критерии оценивания
• Педагогический подход: Не дает прямых ответов, а помогает пользователю самостоятельно найти решение
• Анализ решений: Проверяет решения пользователя, находит ошибки и помогает их исправить
• Персонализированные подсказки: Генерирует подсказки разного уровня в зависимости от прогресса пользователя
• Векторное хранилище: Использует Chroma для хранения базы заданий и их решений
• Удобный интерфейс: Взаимодействие с агентом происходит через чат-интерфейс на базе Gradio

Установка

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

git clone https://github.com/Crayz129/ai-tutor.git
cd math-tutor-agent

2. Установите зависимости:

pip install -r requirements.txt

3. Установите Tesseract OCR:

# Для Ubuntu/Debian
sudo apt-get install tesseract-ocr tesseract-ocr-rus

# Для macOS
brew install tesseract tesseract-lang

# Для Windows скачать установщик с https://github.com/UB-Mannheim/tesseract/wiki

4. Настройте API-ключ для OpenAI (или другой LLM) :

export OPENAI_API_KEY=your_api_key_here

ИЛИ создайте .env с OPENAI_API_KEY

Использование

1. Запустите агента:

python main.py

2. Откройте веб-интерфейс по адресу http://localhost:7860/

3. Взаимодействуйте с тьютором через чат:

• Задавайте вопросы по математике
• Отправляйте задачи для анализа
• Показывайте свои решения для проверки
• Просите подсказки, если затрудняетесь

4. Для создания публичной ссылки используйте параметр --share:

python main.py --share