Настройка

1. Создайте ключ Artillect с provider:write, models:read, images:write, videos:write и projects:write на странице API-ключей и проверьте баланс аккаунта.
2. В Hermes Desktop откройте Settings → Providers → Custom Endpoints. В Applies to выберите профиль текущего чата.
3. Добавьте endpoint: Name — Artillect, Base URL — https://app.artillect.pro/api/v1/provider, API Key — ваш ключ Artillect, Model — openai/gpt-6-luna, API Mode — Chat Completions.
4. Нажмите Test для загрузки моделей, затем Save для сохранения. Успешный Test сам по себе не сохраняет провайдера.
5. Выберите Artillect в списке моделей у поля сообщения или в Settings → Model. Если модели скрыты, включите их в Edit models; если список не обновился, перезапустите Hermes.
6. Для CLI запустите hermes model вне чата и выберите Custom endpoint. Для ручной регистрации именованного провайдера добавьте блоки ниже в существующий config.yaml и .env, сохранив остальные настройки.
7. Добавьте mcp_servers в config.yaml выбранного профиля для генерации медиа через Artillect MCP.
8. Замените art_YOUR_KEY в заголовке MCP и ~/.hermes/.env одним ключом; храните оба файла только локально. Перезапустите Hermes.

# ~/.hermes/config.yaml
providers:
  artillect:
    name: Artillect
    api: https://app.artillect.pro/api/v1/provider
    key_env: ARTILLECT_API_KEY
    transport: chat_completions
    session_affinity_header: X-Session-Id
    default_model: openai/gpt-6-luna
    context_length: 1050000
    models:
      - openai/gpt-6-luna
      - openai/gpt-6.1-sol
      - anthropic/claude-opus-5.5
      - google/gemini-3.8-flash
      - deepseek/deepseek-v4.1-flash
      - qwen/qwen3.8-max-prime
      - anthropic/claude-sonnet-5.5
      - deepseek/deepseek-v4-pro-0813
      - qwen/qwen3.8-flash
      - x-ai/grok-4.7

model:
  provider: custom:artillect
  default: openai/gpt-6-luna
  api_mode: chat_completions
  context_length: 1050000

mcp_servers:
  artillect:
    url: https://app.artillect.pro/mcp
    headers:
      Authorization: "Bearer art_YOUR_KEY"
    timeout: 90

# Replace art_YOUR_KEY in both user-local files; do not commit them.
# ~/.hermes/.env
ARTILLECT_API_KEY=art_YOUR_KEY

Команды export предназначены для Bash/Zsh. В PowerShell задайте те же переменные через$env:ИМЯ = "значение". ARTILLECT_API_KEY — ваш отдельный ключ Artillect; не сохраняйте его в репозитории.

Сайт с собственными медиа

Попросите: «Сделай лендинг кофейни с тремя оригинальными фотографиями. Используй Artillect MCP, сначала покажи оценки цены. Сохрани медиа в выбранный проект Artillect, скачай в public/assets и веди artillect-assets.json с ID задач. При продолжении используй готовые задачи, не генерируй повторно». Рецепт website_media доступен через MCP prompts и get_started.

Первая проверка

Сначала задайте ARTILLECT_API_KEY вашим ключом и выполните команды ниже напрямую в терминале: каталог моделей и баланс проверяются бесплатно. HTTP 200 подтверждает доступ к Provider и аккаунту; это не проверка качества ответа модели. 401 — ключ, 403 — права, 503 — Provider выключен. Обычное сообщение агенту уже вызывает платную модель.

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $ARTILLECT_API_KEY" \
  https://app.artillect.pro/api/v1/provider/models/
curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $ARTILLECT_API_KEY" \
  https://app.artillect.pro/api/v1/me/

Проверьте подключение MCP через список серверов клиента. Для проверки инструментов без LLM вызовите get_started и get_balance напрямую в MCP Inspector: они бесплатны. generate_* оплачивается отдельно. files:write нужен только для загрузки референсов. Превью зависит от клиента; доступ к файлам и терминалу нужен для сборки сайта.