Первый запуск Ultima v5.3

Установка в 1 клик. Всё остальное — в чате с Ultima.

1 Скачай и запусти

Ultima устанавливается одной командой — без терминала, без ручного копирования файлов.

⬇ Windows EXE ⬇ macOS ⬇ Linux
macOS / Linux: сохрани install.sh → открой терминал → bash install.sh
Windows: скачай Ultima-5.3-Setup.exe → запусти → нажми «Установить»
✅ Установка сделает всё сама: Node.js, opencode, oh-my-openagent, ChromaDB, 54+ навыка, engine-5.3. Ничего дополнительно ставить не нужно.

2 Открой Ultima

После установки запусти Ultima — откроется чат с твоим персональным AI-агентом.

💬 Если чат не открылся автоматически — запусти вручную. 
# macOS / Linux:
~/Projects/Ultima/start-ultima.sh

# Windows:
Пуск → Ultima v5.3

3 Вставь ключи в чат

Ultima попросит API-ключи при первом запуске. Просто напиши их в чат — Ultima сама всё настроит.

СервисГде взятьЗачем
OpenRouter openrouter.ai/keys Доступ к DeepSeek, Claude, Gemini
OpenCode Zen opencode.ai/zen Бесплатные базовые модели
GitHub Token github.com/settings/tokens GitHub MCP (issues, PRs, код)
Lazyweb lazyweb.ai Дизайн-референсы (бесплатно)
💡 Без OpenRouter Ultima не сможет вызывать модели. Остальные ключи опциональны.
✅ Как это работает: Напиши в чат мой OpenRouter ключ: sk-or-v1-... — Ultima сама сохранит его, настроит конфиг и проверит соединение.

4 Готово 🎉

Ultima работает. Можешь сразу давать задачи:

• «Напиши пост для Telegram про нейросети»
• «Проверь почту и ответь на письма»
• «Сделай CRO-аудит моего лендинга»
• «Исследуй конкурентов в нише X»
🥳 Ultima готова к работе!
Если что-то понадобится — просто спроси в чате.

Полезные ссылки

Сайт Ultimaivanchepurnov.ru/ultima-win/
GitHubgithub.com/ichepurnov/ultima5
Помощь@ichepurnov

1 Где взять API-ключи

Все ключевые сервисы для Ultima авторизуются через GitHub. Поэтому начинаем с него.

1.1 GitHub (нужен для входа во все сервисы)

GitHub нужен, чтобы логиниться в OpenCode Zen, Lazyweb и другие сервисы. Если аккаунта нет — создать.

  1. Перейти github.com/signup
  2. Ввести email, придумать пароль, подтвердить почту
  3. Готово — GitHub аккаунт создан

1.2 OpenCode Zen (бесплатно)

OpenCode Zen даёт бесплатный доступ к базовым моделям. Нужен всегда. Вход через GitHub.

  1. Перейти opencode.ai/zen
  2. Нажать Get API Key → войти через GitHub
  3. После авторизации — скопировать ключ (начинается с sk-zen-...)
✅ Сохрани в ~/.zshrc: export OPENCODE_ZEN_API_KEY="sk-zen-..."

1.3 OpenRouter (основной, платный)

OpenRouter даёт доступ к 30+ моделям: DeepSeek, Claude, Gemini, GPT. Вход через GitHub. Пополнение от $5.

  1. Перейти openrouter.ai/keys → войти через GitHub
  2. Нажать Create API Key, назвать Ultima
  3. Скопировать ключ (начинается с sk-or-v1-...)
  4. Пополнить баланс: openrouter.ai/credits — минимум $5-10
✅ Сохрани: export OPENROUTER_API_KEY="sk-or-v1-..."

1.4 GitHub Token (доступ к репозиториям)

Для доступа к GitHub MCP (issues, PRs, поиск кода).

  1. Перейти github.com/settings/tokens
  2. Нажать Generate new token → Fine-grained token
  3. Выбрать права: Contents: Read, Issues: Read & Write
  4. Скопировать токен
✅ Сохрани: export GITHUB_TOKEN="github_pat_..."

1.5 Lazyweb (дизайн-референсы, бесплатно)

Lazyweb ищет скриншоты реальных интерфейсов для дизайна. Вход через GitHub.

  1. Перейти lazyweb.ai → войти через GitHub
  2. Скопировать API-ключ из личного кабинета
✅ Сохрани: export LAZYWEB_API_KEY="..."

2 Установка OpenCode CLI

2.1 Установить OpenCode

# Установка opencode через npm (Linux/macOS):
npm install -g oh-my-openagent-linux-x64@latest     # Linux x86_64
npm install -g oh-my-openagent-darwin-arm64@latest  # Mac ARM (M1/M2/M3)
npm install -g oh-my-openagent@latest

# Или одной командой (автоопределение платформы):
bash <(curl -s https://raw.githubusercontent.com/ichepurnov/ultima5/main/install.sh)

# Проверить:
opencode --version

2.2 Клонировать Ultima

git clone https://github.com/ichepurnov/ultima5.git ~/Projects/Ultima

2.3 Настроить конфиг

# Симлинк конфига OpenCode:
mkdir -p ~/.config/opencode
ln -sf ~/Projects/Ultima/configs/opencode.json ~/.config/opencode/opencode.json

2.4 Добавить ключи в окружение

Открой ~/.zshrc и добавь:

# Ultima — API ключи
export OPENCODE_ZEN_API_KEY="sk-zen-...тут-твой-ключ..."
export OPENROUTER_API_KEY="sk-or-v1-...тут-твой-ключ..."
export GITHUB_TOKEN="github_pat_...тут-твой-токен..."
export LAZYWEB_API_KEY="...тут-твой-ключ..."

Примени изменения: source ~/.zshrc

3 Настройка Ultima

3.1 Установка пароля для opencode-web (сервер)

Для удалённого доступа через веб-морду установи пароль:

# Пароль для opencode-web (заменить на свой):
export OPENCODE_SERVER_USERNAME="ichepurnov"
export OPENCODE_SERVER_PASSWORD="твой-пароль"

3.2 Структура проекта

~/Projects/Ultima/
├── configs/
│   └── opencode.json        # Главный конфиг (54+ навыка)
├── personality/             # 9-уровневая иерархия инструкций
├── skills/                  # 54+ навыка (SKILL.md)
├── engine-5.3/              # Движок Ultima 5.3
├── verta/                   # Верта — агент-помощник
├── obsidian/                # Память и база знаний
├── evals/                   # Тесты безопасности
└── scripts/                 # MCP серверы и скрипты
⚠️ Важно: Без OPENROUTER_API_KEY Ultima не сможет вызывать модели. OpenCode Zen даёт бесплатный доступ, но для полной функциональности нужен OpenRouter.

3.3 Первый запуск

# Запустить в терминале:
cd ~/Projects/Ultima
opencode

# Агент загрузит конфиг, навыки и личность Ultima.
✅ Если всё ок: откроется интерфейс OpenCode. Напиши «привет» — агент ответит. Поздравляю, Ultima работает!

4 Яндекс интеграция

4.1 Яндекс Почта

  1. Включить двухфакторную аутентификацию: id.yandex.ru → Безопасность
  2. Включить IMAP: mail.yandex.ru → Настройки → Почтовые клиенты — выбери «С сервера imap.yandex.com по протоколу IMAP» и «Пароли приложений и OAuth-токены»
  3. Создать пароль приложения: id.yandex.ru → Безопасность → Пароли приложений → Почта
  4. Добавить в окружение: 
    export YANDEX_EMAIL="ваш-логин@yandex.ru"
export YANDEX_APP_PASSWORD="сгенерированный-пароль"

4.2 Яндекс Диск

  1. Получить OAuth-токен: yandex.ru/dev/disk/poligon/ → нажать «Получить токен»
  2. Добавить в окружение: 
    export YANDEX_DISK_TOKEN="y0__...полученный-токен..."

4.3 Проверка

# Почта:
python3 -c "import imaplib; m=imaplib.IMAP4_SSL('imap.yandex.com'); m.login('$YANDEX_EMAIL','$YANDEX_APP_PASSWORD'); print('✅ Почта OK'); m.logout()"

# Диск:
curl -s -H "Authorization: OAuth $YANDEX_DISK_TOKEN" \
  "https://cloud-api.yandex.net/v1/disk/" | python3 -c \
  "import json,sys; d=json.load(sys.stdin); print(f'✅ Диск: {d[\"used_space\"]/1024**3:.1f} GB из {d[\"total_space\"]/1024**3:.1f} GB')"

5 Google интеграция

5.1 Gmail

  1. Включить двухфакторную аутентификацию: myaccount.google.com/security
  2. Создать пароль приложения: myaccount.google.com/apppasswords → выбери «Почта» → сгенерировать
  3. Добавить в окружение: 
    export GOOGLE_EMAIL="ваш-логин@gmail.com"
export GOOGLE_APP_PASSWORD="сгенерированный-пароль"

5.2 Google Drive

  1. Установить rclone: brew install rclone (macOS) или apt install rclone (Linux)
  2. Авторизоваться: 
    rclone authorize "drive" --drive-scope "drive.file,drive.readonly"
    Откроется браузер — войди в Google, разреши доступ.
  3. Создать remote: 
    rclone config create ultima drive \
  scope "drive.file,drive.readonly" \
  token 'вставь-токен-из-предыдущего-шага'

5.3 Проверка

# Gmail:
python3 -c "import imaplib; m=imaplib.IMAP4_SSL('imap.gmail.com'); m.login('$GOOGLE_EMAIL','$GOOGLE_APP_PASSWORD'); print('✅ Gmail OK'); m.logout()"

# Google Drive:
rclone ls ultima: --max-depth 1 | head -5 && echo '✅ Drive OK'

6 Финальная проверка

После настройки всех ключей выполни полную проверку:

6.1 Проверка версии OpenCode

# Проверить версию OpenCode:
opencode --version

# Проверить что конфиг подтянулся:
ls -la ~/.config/opencode/opencode.json
# Должен показывать symlink → ~/Projects/Ultima/configs/opencode.json

6.2 Проверка API ключей

# Все ключи в окружении:
echo "OpenRouter: ${OPENROUTER_API_KEY:+✅ есть}"
echo "OpenCode Zen: ${OPENCODE_ZEN_API_KEY:+✅ есть}"
echo "Yandex Mail: ${YANDEX_EMAIL:+✅ есть}"
echo "Google Mail: ${GOOGLE_EMAIL:+✅ есть}"

6.3 Проверка интеграций

# Яндекс:
python3 -c "import imaplib; imaplib.IMAP4_SSL('imap.yandex.com').login('$YANDEX_EMAIL','$YANDEX_APP_PASSWORD').logout(); print('✅ Яндекс Почта')"
curl -s -o /dev/null -w '%{http_code}' -H "Authorization: OAuth $YANDEX_DISK_TOKEN" https://cloud-api.yandex.net/v1/disk/ && echo ' ✅ Яндекс Диск'

# Google:
python3 -c "import imaplib; imaplib.IMAP4_SSL('imap.gmail.com').login('$GOOGLE_EMAIL','$GOOGLE_APP_PASSWORD').logout(); print('✅ Gmail')"
rclone ls ultima: --max-depth 1 >/dev/null 2>&1 && echo '✅ Google Drive'

6.4 Проверка памяти (Memory Compiler)

# Проверить что Obsidian-память доступна:
ls ~/Projects/Ultima/obsidian/
ls ~/Projects/Ultima/obsidian/knowledge-base/
ls ~/Projects/Ultima/obsidian/memory/

# Проверить hooks:
ls ~/Projects/Ultima/skills/ultima-memory-compiler/hooks/

# Сделать тестовую компиляцию:
cd ~/Projects/Ultima
make snapshot

6.5 Проверка навыков

# Список всех навыков:
python3 -c "import json; c=json.load(open('configs/opencode.json')); print(f'Всего навыков: {len(c[\"skills\"])}'); [print(f'  {k}') for k in sorted(c['skills'].keys())]"

# Должно быть 54+ навыка

6.6 Пробный запуск агента

# Запустить агента с тестовой задачей:
opencode --prompt "Привет! Напиши список из 3 вещей, которые ты умеешь делать."

# Агент ответит — значит всё работает!
🥳 Всё готово! Ultima установлен, настроен и проверен. Теперь напиши агенту любую задачу — и смотри, как он работает.

Что дальше

РазделСсылка
Весь проект Ultimaivanchepurnov.ru/ultima/
Дашборд с аналитикойivanchepurnov.ru/dashboard/
Установка на сервер→ Заказать в Telegram
Курс «Нейросети для нулевых»ivanchepurnov.ru/ultima/#program
По всем вопросам: @ichepurnov