Getting StartedНачало работы

From download to your first answer in 15 minutes.От скачивания до первого ответа за 15 минут.

InstallationУстановка

Download MuraveyСкачай Muravey

Go to license.muravey.app/download and click Download for Windows. You'll get a zip file (~4 MB).Перейди на license.muravey.app/download и нажми Скачать для Windows. Получишь zip файл (~4 МБ).

Extract the archiveРаспакуй архив

Right-click the zip → Extract All. Extract to any folder — Desktop, Documents, or a custom folder. Do NOT extract to Program Files (permission issues).Правый клик на zip → Извлечь всё. Распакуй в любую папку — Рабочий стол, Документы. НЕ распаковывай в Program Files (проблемы с правами).

Run INSTALL.batЗапусти INSTALL.bat

Open the extracted folder → open INSTALL.bat as administrator. The installer will automatically:
• Install Python 3.11 (if not present)
• Install AI dependencies (PyQt6, llama-cpp-python)
• Download AI models (~6-7 GB, takes 5-15 min depending on internet)
Открой распакованную папку → запусти INSTALL.bat от имени администратора. Установщик автоматически:
• Установит Python 3.11 (если нет)
• Установит AI зависимости (PyQt6, llama-cpp-python)
• Скачает AI модели (~6-7 ГБ, 5-15 мин в зависимости от интернета)

Install Visual Studio Build Tools (if prompted)Установи Visual Studio Build Tools (если потребуется)

The installer may ask you to install Visual Studio Build Tools — this is needed to compile the AI engine. If the installer opens it automatically:
• Select "Desktop development with C++" workload
• Click Install (bottom right)
• Wait for it to finish (~5-10 min, ~6 GB)
• Go back to the installer window and press Enter

If the installer does NOT ask — skip this step, it means a pre-built version was used.
Установщик может попросить установить Visual Studio Build Tools — это нужно для компиляции AI движка. Если установщик открыл его автоматически:
• Выбери "Разработка классических приложений на C++"
• Нажми Установить (внизу справа)
• Подожди окончания (~5-10 мин, ~6 ГБ)
• Вернись в окно установщика и нажми Enter

Если установщик НЕ попросил — пропусти этот шаг, значит была использована готовая версия.

Wait for models to downloadПодожди пока скачаются модели

This is the longest step. Two AI models will download:
Vision model (Qwen2.5-VL-3B) — reads text from screenshots (~2 GB)
Solver model (Qwen3-8B or Qwen2.5-7B) — solves questions (~4-5 GB)
Progress is shown in the console. Do not close the window.
Это самый долгий шаг. Скачаются две AI модели:
Vision модель (Qwen2.5-VL-3B) — читает текст со скриншотов (~2 ГБ)
Solver модель (Qwen3-8B или Qwen2.5-7B) — решает вопросы (~4-5 ГБ)
Прогресс показан в консоли. Не закрывай окно.

Done — launch MuraveyГотово — запусти Muravey

Double-click start.pyw in the Muravey folder. Click Yes on the admin prompt. Free trial activates automatically. A small icon will appear near the clock (system tray). That's it — Muravey is running! Дважды кликни start.pyw в папке Muravey. Нажми Да на запросе прав. Пробный период активируется автоматически. Иконка появится возле часов (системный трей). Всё — Muravey работает!

How to UseКак пользоваться

Choose your subjectВыбери предмет

Right-click the tray icon (near the clock) → Mode → choose: Mathematics, Physics, Chemistry or Chinese.Правый клик на иконку в трее (возле часов) → Mode → выбери: Mathematics, Physics, Chemistry или Chinese.

Get an answerПолучи ответ

Make sure the question is visible on screen, then press:Убедись что вопрос виден на экране, затем нажми:

Ctrl + `

The ` key is below Escape, left of 1. AI will screenshot, read the question, solve it, and show the answer in 10-50 seconds. Клавиша ` находится под Escape, слева от 1. AI сделает скриншот, прочитает вопрос, решит его и покажет ответ за 10-50 секунд.

Show last answer againПоказать последний ответ

If you missed the answer, press:Если пропустил ответ, нажми:

Ctrl + F1

The last answer will appear for 5 seconds.Последний ответ появится на 5 секунд.

HideСкрыть

To instantly hide everything:Чтобы мгновенно скрыть всё:

Ctrl + Shift + F12

Press again to restore.Нажми снова чтобы восстановить.

Tips for Best ResultsСоветы для лучших результатов

Make the question fully visibleВопрос должен быть полностью виден

AI reads your screen. If the question or answer choices are cut off, scrolled out, or too small — AI can't read them. Make sure everything fits on one screen.AI читает твой экран. Если вопрос или варианты обрезаны, прокручены или слишком мелкие — AI не сможет их прочитать. Убедись что всё помещается на одном экране.

Choose the right modeВыбирай правильный режим

Each mode uses specialized AI prompts. Using Math mode for Chemistry will give worse results. Switch modes via tray icon → Mode.Каждый режим использует специальные AI промпты. Режим Math для Chemistry даст худший результат. Переключай через иконку в трее → Mode.

Retry if answer is wrongПовтори если ответ неверный

AI accuracy is 80-90%. If the answer looks wrong, press Ctrl + ` (the key below Escape, left of 1) again. AI may read the question differently on second try.Точность AI 80-90%. Если ответ выглядит неверным, нажми Ctrl + ` (клавиша под Escape, слева от 1) ещё раз. AI может прочитать вопрос иначе при повторе.

First question is always slowerПервый вопрос всегда медленнее

On first press, AI models load into memory (~10-30 sec extra). After that, answers come faster.При первом нажатии AI модели загружаются в память (~10-30 сек дополнительно). После этого ответы приходят быстрее.

Common IssuesЧастые проблемы

SmartScreen warning when running INSTALL.batПредупреждение SmartScreen при запуске INSTALL.bat

Click "More info""Run anyway". This is normal for unsigned software.Нажми "Подробнее""Выполнить в любом случае". Это нормально для неподписанного ПО.

Installation stuck / model download failsУстановка зависла / модель не скачивается

Close the window and run INSTALL.bat again. Downloads resume from where they stopped. Make sure you have at least 15 GB free disk space.Закрой окно и запусти INSTALL.bat заново. Скачивание продолжится с места остановки. Убедись что есть минимум 15 ГБ свободного места.

No tray icon after launchНет иконки в трее после запуска

Click the "^" arrow near the clock to show hidden icons. If still absent, open CONSOLE.bat and type python launch.py to see error messages.Нажми стрелку "^" возле часов чтобы показать скрытые иконки. Если всё равно нет — открой CONSOLE.bat и введи python launch.py чтобы увидеть ошибки.

Answer shows ".." or nothingОтвет показывает ".." или ничего

AI couldn't read the question. Make sure all text and answer choices are clearly visible on screen. Try increasing the font size or zooming in.AI не смог прочитать вопрос. Убедись что весь текст и варианты ответов чётко видны. Попробуй увеличить шрифт или приблизить.

More questions? Check FAQ or contact @Muravey_Support_botБольше вопросов? Смотри FAQ или пиши @Muravey_Support_bot