Встановлення

M.A.V.E.N працює на вашій машині. Немає ні хостингового тарифу, ні облікового запису - ви розпаковуєте або клонуєте його, надаєте облікові дані для потрібних моделей і агентів та запускаєте.

Золоте правило: перевірте, перш ніж встановлювати

Кожна залежність нижче має команду перевірки. Спершу виконайте її; встановлюйте лише тоді, коли перевірка не пройшла. На машині вже можуть бути Node, Ollama, Hermes чи Chromium, а повторне встановлення загрожує конфліктами версій.

command -v <tool>      # prints a path and exits 0 if installed → skip it

M.A.V.E.N побудований навколо цього: кожен застосунок деградує м’яко. Якщо зовнішнього інструмента застосунку немає, цей застосунок показує картку налаштування з інструкціями - решта дашборда працює. Спершу встановіть M.A.V.E.N; інструменти додавайте лише для тих застосунків, якими справді користуєтеся.

Вимоги

• Node.js ≥ 20 (перевірено на v24) і npm - єдина жорстка вимога.
• git, якщо встановлюєте з репозиторію (самооновлення тягне зміни з нього).
• python3 для шлюзу безпеки навичок і кількох рушіїв.
• Оболонка. Linux (systemd), macOS (launchd) і Windows (Scheduled Task) мають кожен свій інсталятор автозапуску.

Немає системного Node і прав адміністратора? Встановіть локальну копію для користувача:

curl -fSL https://nodejs.org/dist/v24.18.0/node-v24.18.0-$(uname -s | tr A-Z a-z)-$(uname -m | sed 's/x86_64/x64/;s/aarch64/arm64/').tar.gz -o /tmp/node.tar.gz
mkdir -p ~/.local && tar -xzf /tmp/node.tar.gz -C ~/.local && mv ~/.local/node-v24* ~/.local/node
export PATH="$HOME/.local/node/bin:$PATH"     # add this line to your shell profile too

Отримайте код

З релізного zip (звичайний шлях для нової машини):

unzip maven-6.16.0.zip -d ~/maven && cd ~/maven

Або з репозиторію - тоді лишається доступним оновлювач усередині застосунку:

git clone <repository-url> ~/maven && cd ~/maven

Репозиторій приватний; для клонування потрібен токен GitHub із правом читання. Встановлення без git-репозиторію не може підтягувати оновлення; його оновлюють, розпаковуючи новіший zip.

Linux

cd ~/maven
npm install
cp .env.example .env.local                 # then edit - every key is optional
bash scripts/setup-skill-validator.sh      # the skill-security gate (needs python3)
npm run dev                                # → http://localhost:3000

Для машини, що працює довго, встановіть M.A.V.E.N як сервіс. Інсталятор один раз збирає проєкт, реєструє користувацький юніт systemd (maven.service, перезапуск після збою, двохвилинний сторожовий таймер стану) і розгортає безкоштовні офлайн-рушії:

bash scripts/install-autostart.sh --now
loginctl enable-linger "$USER"             # or the service stops when you log out

Після цього не запускайте npm run dev вручну - порт 3000 належить сервісу. Перезапускайте його командою systemctl --user restart maven; логи читайте через journalctl --user -u maven -f.

macOS

Ті самі перші чотири команди, що й для Linux. Далі або запустіть npm run dev у терміналі, або зареєструйте агент launchd:

bash scripts/install-autostart-macos.sh --now

Він записує LaunchAgent, який запускає M.A.V.E.N під час входу в систему і перезапускає після збою. Перезапуск - launchctl kickstart -k gui/$(id -u)/com.maven.mission-control; логи потрапляють у ~/Library/Logs/.

Windows

Використовуйте PowerShell (або Git Bash для Unix-подібних команд з інших інструкцій):

cd ~\maven
npm install
Copy-Item .env.example .env.local
npm run dev                                # → http://localhost:3000

Для автозапуску один раз виконайте scripts/install-autostart-windows.ps1 - він розгортає ті самі рушії та реєструє Scheduled Task з іменем MAVEN, що стартує при вході в систему. Зупиняйте й запускайте його командами Stop-ScheduledTask -TaskName MAVEN / Start-ScheduledTask -TaskName MAVEN.

Облікові дані

Скопіюйте файл-приклад оточення й заповніть лише потрібні ключі. Для запуску нічого не обов’язкове; кожен провайдер вмикається, щойно з’являється його ключ.

cp .env.example .env.local

Файли оточення читаються лише під час запуску сервера - після редагування перезапустіть. Ключі можна також додавати з Settings → Secrets усередині застосунку - це записує той самий файл. Дивіться Конфігурацію, щоб дізнатися, що де лежить, і Додати API-ключ для покрокової інструкції.

Необов’язкові інструменти

Кожен застосунок каже, що йому потрібно, на своїй сторінці. Короткий список із перевіркою:

Застосунок(и)	Інструмент	Перевірка
Chat (рушій Claude) · Loop · Pipeline · SEO-Forge · M-Forge Compose / OpenMontage · Мастермайнд	Claude Code CLI	command -v claude
Chat (Codex)	OpenAI Codex CLI	command -v codex
Chat (Grok)	Grok Build CLI	command -v grok
Chat (Antigravity)	CLI agy або проксі Antigravity	command -v agy
Chat (Qwen Code)	CLI qwen	command -v qwen
Chat (Local) · локальний суддя Loop	Ollama + завантажена модель	command -v ollama
Hermes · Kanban · Hermes Swarm · Game Studio	Hermes Agent	command -v hermes
OpenClaw	OpenClaw	command -v openclaw
OpenCode	OpenCode CLI	command -v opencode
Курси P-Forge · M-Forge Studio	python3, ffmpeg, rsvg-convert	command -v python3 ffmpeg rsvg-convert
G-Forge · рендери P-Forge	Blender + Godot (portable)	blender --version
Open Design	демон open-design	curl -s 127.0.0.1:7456/api/health
Paperclip	застосунок Paperclip на :3100	curl -s 127.0.0.1:3100

scripts/setup-free-engines.sh розгортає безкоштовні офлайн-рушії (Kokoro, Supertonic, Whisper, yt-dlp); scripts/setup-3d-engines.sh - 3D-рушії; інсталятори автозапуску виконують обидва. Повна матриця - у DEPENDENCIES.md в репозиторії.

PATH для запущених CLI. M.A.V.E.N запускає агентів із PATH, доповненим ~/.local/bin, ~/.local/node/bin, /opt/homebrew/bin і /usr/local/bin. Інструмент, що лежить деінде, - зробіть на нього симлінк у ~/.local/bin.

Розгортання на сервері

Це працює, але з застереженнями: M.A.V.E.N запускає CLI на хості, а єдина його автентифікація - PIN віддаленого доступу. Встановіть агентів на тому сервері, увійдіть у Claude командою claude setup-token, залиште прив’язку на loopback і заходьте через Tailscale або SSH-тунель

• ніколи не відкривайте порт 3000 в інтернет. Прочитайте Безпека й віддалений доступ, перш ніж відкривати його будь-якому іншому хосту.

Далі

• Швидкий старт - перший чат, глобальна модель, перший Мастермайнд.
• Конфігурація - де живуть стан і ключі.
• Оновлення - перехід встановлення на новішу версію на місці.