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

Erebros хранит свою конфигурацию в нескольких известных местах. Все они находятся на вашей машине.

`.env.local`

Учётные данные провайдеров и переключатели времени выполнения, в корне проекта. Файл в gitignore и никогда не включается в релизный zip. Читается только при старте — перезапустите после правки или редактируйте через Настройки → Секреты и ключи, которые пишут тот же файл и применяют изменения сразу.

Задавайте только те ключи, которыми пользуетесь; каждый провайдер включается, когда его ключ присутствует. Наиболее употребимые:

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_EREBROS_UPDATE=     # read token for the in-app updater (private repo)

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

Пути

EREBROS_VAULT_DIR — папка Obsidian, куда дописываются чаты, цели и записи журнала, по одному markdown-файлу в день. Укажите любую доступную для записи папку, если не пользуетесь Obsidian. Корень хранилища (vault) — её родитель: по умолчанию ~/Obsidian/Erebros, с Memories/, Notebooks/, Pipeline/, Room/ и одной папкой на каждое приложение Forge.
EREBROS_VAULT_BROWSE_ROOT — то, что читает приложение Память (поиск + граф) по всем вашим хранилищам; по умолчанию ~/Obsidian. Только чтение.
~/.erebros — состояние времени выполнения, создаётся автоматически и никогда не поставляется: settings.json (глобальная модель, настройки приложений), история chat/, логи jobs/, движки и venv отдельных приложений, PIN удалённого доступа, учёт обновлений.

`agents.config.json`

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

Настройки

Шестерёнка в подвале боковой панели открывает Настройки — левая рейка плюс поиск:

Обновления — проверить сейчас, два ежедневных часа проверки, автообновление вкл/выкл. См. Обновление.
Маршрутизация моделей — пропускать провайдеров, которые только что упали и переключаться на другую модель, обе по умолчанию выключены.
Секреты и ключи — каждый ключ, замаскированный; добавляйте, меняйте или удаляйте, не трогая файл.
Безопасность — PIN удалённого доступа, разрешённые хосты и дневной потолок расходов. См. Безопасность и удалённый доступ.
Внешний вид — тема (Black / Navy), звук, язык (EN / UK / RU).
Модели / Агенты / Forge / Self — карточки-переключатели, показывающие или скрывающие любой пункт боковой панели, с Скрыть все / Показать все для каждого раздела. Скрытие приложения убирает его из боковой панели, флота на Дашборде и радара; ничего при этом не останавливается.

Чисто визуальные предпочтения живут в localStorage; всё остальное — в ~/.erebros/settings.json.

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

Кнопка Модели в верхней панели перечисляет каждое семейство моделей, до которого может дотянуться эта установка, сколько каждое стоит, и переключатель, выключающий любое семейство или отдельную модель везде. Каждый пикер в каждом приложении — ряд движков в Чате, бокс глобальной модели, пикеры Forge, состав Мастермайнда — фильтруется через него. Сам менеджер никогда не фильтруется, так что вы всегда можете включить что-то обратно. См. Менеджер моделей.

`next.config.ts` — разрешённые dev-origin

Dev-режим Next отказывается отдавать свои ресурсы /_next/* любому origin, кроме localhost. Список заранее заполнен 127.0.0.1, localhost, именем хоста, IP в локальной сети и *.local. Если вы обращаетесь к dev-серверу другим способом, добавьте этот хост в allowedDevOrigins и перезапустите — иначе страницы загружаются пустыми. (Удалённым хостам также нужен шлюз безопасности — см. Безопасность.)