Установка

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

Для долгоживущей машины установите его как сервис. Установщик собирает проект один раз, регистрирует пользовательский юнит systemd (maven.service, перезапуск при падении, двухминутный watchdog здоровья) и провижинит бесплатные офлайн-движки:

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

Файлы окружения читаются только при старте сервера - перезапустите после правки. Ключи можно также добавлять из Настройки → Секреты и ключи внутри приложения, которые пишут тот же файл. См. Конфигурация о том, что где лежит, и Добавить API-ключ для пошаговой инструкции.

Дополнительные инструменты

Каждое приложение на своей странице говорит, что ему нужно. Краткий список с проверкой:

Приложение(я)	Инструмент	Проверка
Чат (движок Claude) · Loop · Пайплайн · SEO-Forge · M-Forge Compose / OpenMontage · Мастермайнд	Claude Code CLI	command -v claude
Чат (Codex)	OpenAI Codex CLI	command -v codex
Чат (Grok)	Grok Build CLI	command -v grok
Чат (Antigravity)	CLI agy или прокси Antigravity	command -v agy
Чат (Qwen Code)	CLI qwen	command -v qwen
Чат (Local) · локальный судья Loop	Ollama + скачанная модель	command -v ollama
Hermes · Канбан · 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 (портативные)	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 в интернет. Прочтите Безопасность и удалённый доступ, прежде чем открывать его любому другому хосту.

Дальше

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