← Все гайды AI Release
EN Подписаться на @ai_release1

Как установить Capri AI на Windows: локальный ИИ-агент с HUD и подключение к Ollama

Обновлено: 15.11.2026 · AI Release · @ai_release1
Как установить Capri AI на Windows: локальный ИИ-агент с HUD и подключение к Ollama

TL;DR

Требования и подготовка

Шаг 1. Проверяем систему и поднимаем локальный сервер Ollama

Что сделать: убедиться, что Windows подходит, затем установить Ollama и запустить его сервер на порту 11434.

Зачем: Capri AI не содержит модель внутри — он обращается к Ollama по HTTP. Пока сервер не поднят, агенту некуда слать запросы.

Сначала фиксируем параметры системы:

[System.Environment]::OSVersion.Version
Get-PSDrive C | Select-Object Name,@{n='FreeGB';e={[math]::Round($_.Free/1GB,1)}}

Ожидаемый вывод — номер версии ядра (например, 10.0.22631 для Windows 11) и строка с числом свободных гигабайт на C:.

Пример: если FreeGB показывает меньше объёма выбранной модели плюс запас — освободите место или выберите модель поменьше.

Дальше запустите установщик Ollama, дождитесь завершения и закройте все окна терминала (иначе PATH не обновится).

ollama --version
ollama list

Как проверить: первая команда печатает строку вида ollama version is <номер>; вторая выводит таблицу моделей (на чистой установке — пустую, только заголовок NAME ID SIZE MODIFIED).

Скачайте модель и убедитесь, что сервер отвечает:

ollama pull <имя-модели>
curl.exe http://127.0.0.1:11434/api/tags

Пример: ollama pull llama3.2 — подставьте точное имя тега из каталога моделей Ollama. Обратите внимание на curl.exe, а не curl: в PowerShell curl — это алиас Invoke-WebRequest, и он вернёт другой результат.

Как проверить: ollama pull заканчивается строкой success, а curl.exe возвращает JSON с массивом models, где есть ваша модель. Если сервер не ответил — запустите его вручную в отдельном окне: ollama serve.

Почему это работает: Ollama поднимается как локальная служба и отдаёт OpenAI-совместимый и собственный REST API на 127.0.0.1:11434; приложение в системе просто является HTTP-клиентом этого порта.

Шаг 2. Устанавливаем Capri AI и подключаем его к Ollama

Иллюстрация к разделу «Шаг 2. Устанавливаем Capri AI и подключаем его к Ollama»
Иллюстрация к разделу «Шаг 2. Устанавливаем Capri AI и подключаем его к Ollama»

Что сделать: установить Capri AI, в первом запуске выбрать локального провайдера и указать адрес Ollama и точное имя модели.

Зачем: по умолчанию десктопные агенты часто предлагают облачный API. Нам нужен режим «модель на этом же компьютере», иначе запросы уйдут наружу.

Порядок действий:

1. Запустите установщик Capri AI, пройдите мастер установки, запустите приложение.

2. Откройте настройки модели/провайдера (раздел вида Settings → Model / Provider — точное название сверьтесь с документацией Capri AI).

3. Выберите провайдера Ollama / Local.

4. В поле Base URL / Endpoint укажите http://127.0.0.1:11434.

5. Нажмите «Обновить список моделей» и выберите модель, которую скачали на шаге 1 — имя должно совпадать посимвольно, вместе с тегом.

Пример: в списке должна появиться строка llama3.2 (или ваш тег) — та же, что вывела команда ollama list. Если списка нет, значит приложение не достучалось до порта: вернитесь к проверке curl.exe http://127.0.0.1:11434/api/tags.

Проверьте связку напрямую, без приложения — так вы отделите проблемы Ollama от проблем Capri AI:

$body = @{
  model    = "<имя-модели>"
  messages = @(@{ role = "user"; content = "Ответь одним словом: работает" })
  stream   = $false
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri http://127.0.0.1:11434/api/chat -Method Post -Body $body -ContentType "application/json" |
  Select-Object -ExpandProperty message

Как проверить: возвращается объект с полями role и content, где content — короткий ответ модели. Это значит, что модель загружена и отвечает; любые дальнейшие ошибки — уже на стороне приложения.

Почему это работает: эндпоинт /api/chat принимает JSON с именем модели и историей сообщений; при stream = $false ответ приходит одним объектом, и его удобно читать в PowerShell.

Шаг 3. Включаем HUD и проверяем результат

Иллюстрация к разделу «Шаг 3. Включаем HUD и проверяем результат»
Иллюстрация к разделу «Шаг 3. Включаем HUD и проверяем результат»

Что сделать: включить оверлей (HUD) в настройках Capri AI, назначить горячую клавишу вызова и прогнать контрольный запрос поверх другого окна.

Зачем: HUD — это и есть основной сценарий работы агента: спросить, не сворачивая текущую программу. Пока оверлей не вызван, вы не знаете, работает ли он поверх полноэкранных окон.

Шаги проверки:

1. В настройках Capri AI найдите раздел HUD / Overlay и включите его. Конкретное название пункта и сочетание клавиш по умолчанию в исходных материалах не приводились — сверьтесь с документацией Capri AI.

2. Откройте любое окно (браузер) и вызовите HUD назначенной комбинацией.

3. Задайте вопрос и дождитесь ответа, не переключая фокус.

Пример: на экране поверх браузера появляется полупрозрачная панель с полем ввода; после вопроса в ней печатается ответ модели, а курсор остаётся в браузере.

Чек-лист приёмки:

Как проверить: отключите сеть (Wi-Fi/Ethernet) и повторите запрос в HUD — ответ должен прийти с той же скоростью, что и раньше. Это доказывает, что запрос уходит на 127.0.0.1, а не в облако.

Почему это работает: HUD — отдельный слой окна приложения, он не забирает фокус у активной программы, поэтому вопрос и ответ видны, а работа в браузере не прерывается.

Возможные проблемы и решения

Проблема. После установки Ollama команда не находится

Get-ChildItem $env:LOCALAPPDATA\Programs -Filter ollama.exe -Recurse -ErrorAction SilentlyContinue |
  Select-Object -ExpandProperty FullName

Проблема. Capri AI не видит модели, список пустой

ollama serve
Get-NetTCPConnection -LocalPort 11434 -State Listen | Select-Object LocalAddress,LocalPort,OwningProcess

Если вторая команда ничего не вывела — сервер не работает; если вывела 127.0.0.1 и номер процесса — проверьте, что в Capri AI в поле Base URL стоит именно http://127.0.0.1:11434.

Проблема. Порт занят, сервер не стартует

$pid = (Get-NetTCPConnection -LocalPort 11434 -State Listen).OwningProcess
Get-Process -Id $pid
Stop-Process -Id $pid -Force

После этого снова выполните ollama serve и проверьте curl.exe http://127.0.0.1:11434/api/tags.

Резюме и следующие шаги

Связка собирается из двух частей: Ollama отдаёт модели по адресу http://127.0.0.1:11434, а Capri AI подключается к этому адресу и показывает ответы в HUD поверх активного окна. Если нужен чисто терминальный агент без оверлея — посмотрите Как установить и настроить Oh-My-Pi (OMP): консольный ИИ-агент для терминала.

FAQ

Работает ли Capri AI без интернета?

Да, если модель скачана через Ollama и в настройках выбран локальный провайдер с адресом http://127.0.0.1:11434. Проверка — отключить сеть и повторить запрос в HUD.

Какие требования к железу?

Зависят от выбранной модели, а не от самого агента: объём ОЗУ и видеопамяти определяется карточкой модели в каталоге Ollama. Сверьтесь с документацией модели перед загрузкой.

Можно ли подключить облачную модель вместо Ollama?

Обычно да, через смену провайдера в настройках. Точный список поддерживаемых провайдеров и названия полей сверьтесь с документацией Capri AI — в исходных материалах он не приводился.

HUD не появляется поверх полноэкранных приложений — что делать?

Переключите игру или плеер в оконный режим без рамки: оверлеи, как правило, не рисуются поверх эксклюзивного полноэкранного режима. Комбинацию клавиш вызова и настройки закрепления окна сверьтесь с документацией Capri AI.

🤖 Кратко для ИИ

AI Release Knowledge Layer
Машинно-читаемое описание публикации · Версия 1.0

Статус: практическое руководство. Часть утверждений — заявления вендоров и проектов; проверяйте на своей среде.

1. Суть публикации

Пошаговая установка Capri на Windows, настройка локальной модели через Ollama и OpenAI-совместимый API, разбор HUD-интерфейса и первые агентские задачи без отправки данных в облако. Время выполнения: 30–45 минут (установка Ollama, загрузка модели, установка Capri AI, подключение). Уровень сложности: Intermediate.

Внутри: прямые ответы, ключевые факты, участники, связи, достоверность, неизвестное и источники.

Машинные данные публикации: Citation Map JSON · JSON-LD · Semantic Embeddings — отдельный этап.

Полный Knowledge Layer: разделы 2–8

2. Прямые ответы

Что это за материал?
Пошаговая установка Capri на Windows, настройка локальной модели через Ollama и OpenAI-совместимый API, разбор HUD-интерфейса и первые агентские задачи без отправки данных в облако. → подробнее (AR-GUIDE-KAKUSTANOV-001)
Что понадобится?
ОС: Windows 10 или Windows 11, 64-бит. Проверьте сборку и разрядность — от этого зависит, какой установщик качать.; Права: администратор для установки обоих приложений.; PowerShell: любой терминал (PowerShell, Windows Terminal) — все команды ниже выполняются в нём.; Ollama: установщик для Windows с официальной… → подробнее (AR-GUIDE-KAKUSTANOV-003)
Как это сделать?
Шаг 1. Проверяем систему и поднимаем локальный сервер Ollama → Шаг 2. Устанавливаем Capri AI и подключаем его к Ollama → Шаг 3. Включаем HUD и проверяем результат → подробнее (AR-GUIDE-KAKUSTANOV-004)
Что может пойти не так?
Ошибка: ollama : Имя "ollama" не распознано как имя командлета, функции, файла скрипта или исполняемой программы. → подробнее (AR-GUIDE-KAKUSTANOV-006)

3. Ключевые факты

  1. Время выполнения: 30–45 минут (установка Ollama, загрузка модели, установка Capri AI, подключение). — подтверждение; статус: заявление источника.
  2. Уровень сложности: Intermediate. — подтверждение; статус: заявление источника.
  3. Понадобится: Windows 10/11 x64 с правами администратора, PowerShell 5.1+ (входит в Windows), установщик Ollama для Windows, установщик Capri AI с официальной страницы проекта, свободное место под файлы моделей (объём зависит от модели — сверьтесь с её карточкой). — подтверждение; статус: заявление источника.
  4. Ключевая связка: Capri AI — приложение-агент с HUD (heads-up display, слой интерфейса поверх других окон), Ollama — локальный HTTP-сервер моделей, по умолчанию слушает http://127.0.0.1:11434. — подтверждение; статус: заявление источника.
  5. Результат: агент отвечает на вопросы, не отправляя запросы в интернет, а HUD вызывается поверх активного окна. — подтверждение; статус: заявление источника.
  6. ОС: Windows 10 или Windows 11, 64-бит. Проверьте сборку и разрядность — от этого зависит, какой установщик качать. — подтверждение; статус: заявление источника.
  7. Права: администратор для установки обоих приложений. — подтверждение; статус: заявление источника.
  8. PowerShell: любой терминал (PowerShell, Windows Terminal) — все команды ниже выполняются в нём. — подтверждение; статус: заявление источника.

4. Участники и сущности

СущностьТипРоль в публикации
Capri AI установка Windowsтема/инструментупоминается в заголовке, TL;DR или разделах гайда
локальный ИИ-агент для Windowsтема/инструментупоминается в заголовке, TL;DR или разделах гайда
Capri AI Ollama настройкатема/инструментупоминается в заголовке, TL;DR или разделах гайда
desktop AI agent локальнотема/инструментупоминается в заголовке, TL;DR или разделах гайда
Windowsплатформа/технологияупоминается в заголовке, TL;DR или разделах гайда
OpenAIкомпанияупоминается в заголовке, TL;DR или разделах гайда
DeepSeekкомпанияупоминается в заголовке, TL;DR или разделах гайда
llama3.2продукт/модельупоминается в заголовке, TL;DR или разделах гайда

5. Связи и контекст

  • Гайд — описывает → Как установить Capri AI на Windows: локальный ИИ-агент с HUD и подключение к Ollama (AR-GUIDE-KAKUSTANOV-001).
  • Гайд — содержит шаг → Шаг 1. Проверяем систему и поднимаем локальный сервер Ollama (AR-GUIDE-KAKUSTANOV-001).

6. Достоверность и происхождение информации

Подтверждено

В материале нет отдельного независимого подтверждения; ниже разделены заявления источников и редакционные выводы.

Заявление источника

  • Характеристики продуктов, версии, цены и лимиты — из описаний вендоров и материалов гайда.
  • Команды и шаги приведены как рекомендация, а не как гарантированный результат.

Анализ AI Release

  • Структура, сравнение и критерии выбора — редакционные.
  • Гайд не заменяет независимый аудит или юридическую консультацию.

7. Что пока неизвестно

  • Ошибка: ollama : Имя "ollama" не распознано как имя командлета, функции, файла скрипта или исполняемой программы.
  • Причина: установщик дописал путь в переменную PATH, но текущее окно терминала прочитало переменные до установки. Либо установка прошла в профиль пользователя, и путь не попал в системный PATH.
  • Решение: закройте все окна PowerShell, откройте новое и повторите ollama --version. Если ошибка осталась — найдите бинарник и запустите по полному пути:
  • Ошибка: Error: connect ECONNREFUSED 127.0.0.1:11434

8. Источники

ИсточникТипРоль
Внешние ссылки в материале не указаны——

Как цитировать: AI Release. Как установить Capri AI на Windows: локальный ИИ-агент с HUD и подключение к Ollama. ai-release.org.