Конфігурація

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

.env.local

Облікові дані провайдерів і перемикачі середовища виконання, у корені проєкту. Файл у gitignore і ніколи не потрапляє в релізний zip. Читається лише під час запуску - після редагування перезапустіть або редагуйте через Settings → Secrets, що записує той самий файл і застосовує одразу.

Задавайте лише ті ключі, якими користуєтеся; кожен провайдер вмикається, щойно з’являється його ключ. Найуживаніші:

KIMI_API_KEY=            # Kimi engine (platform.moonshot.ai)
ZAI_API_KEY=             # Z.AI GLM engine (set from the Chat account panel)
QWEN_CLOUD_KEY=          # Qwen + DeepSeek on the Alibaba Model Studio plan
OPENAI_API_KEY=          # Codex fallback, infographics
OMNIROUTE_API_KEY=       # OmniRoute gateway
OPENROUTER_API_KEY=      # PROVIDERS - any one of the three is enough
FREEINFERENCE_API_KEY=
TOKENROUTER_API_KEY=
FAL_KEY=                 # image/video engines (Thumbnails, S-Forge, OpenMontage)
KIE_API_KEY=             # second image/video provider
MAGNIFIC_API_KEY=        # X-Forge
SUNO_API_KEY=            # M-Forge → Music
ELEVENLABS_API_KEY=      # paid narration / dubbing (free Supertonic needs nothing)
GEMINI_API_KEY=          # Google TTS / infographics
TAVILY_API_KEY=          # R-Forge, N-Forge web search, Ad Scout
FIRECRAWL_API_KEY=
MESHY_API_KEY=           # G-Forge (test mode without it)
HF_TOKEN=                # M-Forge cloud watermark removal
GITHUB_MAVEN_UPDATE=     # read token for the in-app updater (private repo)

Claude, Grok, Codex, Antigravity, Qwen Code, Hermes, OpenClaw, OpenCode, Ollama і Open Design ключа тут не потребують - кожен використовує власний вхід.

Шляхи

• MAVEN_VAULT_DIR - тека Obsidian, куди дописуються чати, цілі й записи журналу, один markdown-файл на день. Вкажіть будь-яку теку з правом запису, якщо не користуєтеся Obsidian. Корінь сховища (vault) - її батьківська тека: типово ~/Obsidian/maven-os з Memories/, Notebooks/, Pipeline/, Room/ і окремою текою для кожного застосунку Forge.
• MAVEN_VAULT_BROWSE_ROOT - те, що читає застосунок Memory (пошук + граф) по всіх ваших сховищах; типово ~/Obsidian. Лише читання.
• ~/.maven - стан середовища виконання, створюється автоматично й ніколи не постачається: settings.json (глобальна модель, конфігурація застосунків), історія chat/, логи jobs/, рушії та venv окремих застосунків, PIN віддаленого доступу, облік оновлень.

agents.config.json

Парк CLI-агентів: один запис на агента (id, name, command, args з {prompt}, колір, гліф, підключення навичок). Перечитується при оновленні сторінки - без перезапуску - і оновлювач ніколи його не перезаписує. Будь-який новий CLI-агент отримує пікер skills.sh (skillsShAgent + skillsDir); виняток - Hermes, який використовує власний реєстр.

Налаштування

Шестерня в підвалі бічної панелі відкриває Settings - ліву колонку плюс пошук:

• Updates - перевірити зараз, дві години щоденної перевірки, автооновлення увімк./вимк. Дивіться Оновлення.
• Model routing - пропускати провайдерів, які щойно відмовили і переходити на іншу модель, обидва типово вимкнені.
• Secrets - усі ключі, замасковані; додавайте, міняйте чи видаляйте, не торкаючись файлу.
• Security - PIN віддаленого доступу, дозволені хости й денна стеля витрат. Дивіться Безпека й віддалений доступ.
• Appearance - тема (Black / Navy), звук, мова (EN / UK / RU).
• Models / Agents / Forge / Self - перемикачі-картки, що показують або ховають будь-який пункт бічної панелі, з Hide all / Show all для кожного розділу. Приховування застосунку прибирає його з бічної панелі, парку на дашборді й радара; воно нічого не зупиняє.

Суто візуальні вподобання живуть у localStorage; усе інше - у ~/.maven/settings.json.

Менеджер моделей

Кнопка Models у верхній панелі перелічує всі сімейства моделей, доступні цьому встановленню, вартість кожного і перемикач, що вимикає будь-яке сімейство чи окрему модель скрізь. Кожен пікер у кожному застосунку - рядок рушіїв у Chat, поле глобальної моделі, пікери Forge, склад Мастермайнда - фільтрується через нього. Сам менеджер ніколи не фільтрується, тож ви завжди можете щось увімкнути назад. Дивіться Менеджер моделей.

next.config.ts - дозволені dev-origin

Режим розробки Next відмовляє у своїх ресурсах /_next/* будь-якому origin, крім localhost. Список наперед заданий: 127.0.0.1, localhost, hostname, IP у LAN і *.local. Якщо ви заходите на dev-сервер іншим шляхом, додайте цей хост до allowedDevOrigins і перезапустіть - інакше сторінки завантажуються порожніми. (Віддаленим хостам також потрібен шлюз безпеки - дивіться Безпека.)