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

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-ustanovit-capri-ai-na-windows-lokalnyy-ii-agent-s-h.html

## TL;DR

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

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

- ОС: Windows 10 или Windows 11, 64-бит. Проверьте сборку и разрядность — от этого зависит, какой установщик качать.
- Права: администратор для установки обоих приложений.
- PowerShell: любой терминал (PowerShell, Windows Terminal) — все команды ниже выполняются в нём.
- Ollama: установщик для Windows с официальной страницы загрузки Ollama (сверьтесь с документацией — имя файла и версию берите оттуда, здесь они не приводятся).
- Capri AI: установщик с официальной страницы проекта/репозитория. Точное имя файла, версия и пункты меню в исходных материалах не приводились — сверьтесь с документацией Capri AI.
- Модель: любая модель из библиотеки Ollama в формате GGUF; точное имя тега смотрите в каталоге моделей (сверьтесь с документацией Ollama).
- Если система давно не обновлялась и установщики падают на этапе распаковки — сначала обновите Windows: [Как установить Windows 11 26H2: пошаговая инструкция с официального ISO](https://ai-release.org/guides/kak-ustanovit-windows-11-26h2-poshagovaya-instruktsiya.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).
- Если параллельно тестируете другие десктопные ИИ-клиенты — держите их на разных портах: [DeepSeek Harness Desktop: как установить и подключить плагины на Windows и Mac](https://ai-release.org/guides/deepseek-harness-desktop-kak-ustanovit-i-podklyuchit-pl.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

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

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

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

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

```powershell
[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 не обновится).

```powershell
ollama --version
ollama list
```

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

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

```powershell
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»](https://ai-release.org/guides/img/kak-ustanovit-capri-ai-na-windows-lokalnyy-ii-agent-s-h-ru-2.jpg?v=1794753386)


**Что сделать:** установить 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:

```powershell
$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 и проверяем результат»](https://ai-release.org/guides/img/kak-ustanovit-capri-ai-na-windows-lokalnyy-ii-agent-s-h-ru-3.jpg?v=1794753390)


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

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

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

1. В настройках Capri AI найдите раздел HUD / Overlay и включите его. Конкретное название пункта и сочетание клавиш по умолчанию в исходных материалах не приводились — сверьтесь с документацией Capri AI.
2. Откройте любое окно (браузер) и вызовите HUD назначенной комбинацией.
3. Задайте вопрос и дождитесь ответа, не переключая фокус.

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

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

- [ ] `ollama list` показывает выбранную модель.
- [ ] `curl.exe http://127.0.0.1:11434/api/tags` возвращает JSON с этой моделью.
- [ ] В Capri AI в списке моделей видно то же имя тега.
- [ ] Ответ на тестовый вопрос приходит при отключённом интернете.
- [ ] HUD вызывается горячей клавишей и отображается поверх активного окна.

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

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

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

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

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

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

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

- Ошибка: `Error: connect ECONNREFUSED 127.0.0.1:11434`
- Причина: сервер Ollama не запущен (перезагрузка, закрытый трей) или приложение обращается к другому порту.
- Решение: поднимите сервер в отдельном окне и проверьте, кто слушает порт:

```powershell
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`.

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

- Ошибка: `Error: listen EADDRINUSE: address already in use 127.0.0.1:11434`
- Причина: уже запущен второй экземпляр Ollama (например, автозапуск из трея плюс ручной `ollama serve`).
- Решение: не запускайте второй экземпляр — используйте работающий. Если нужно перезапустить, завершите процесс, который держит порт:

```powershell
$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): консольный ИИ-агент для терминала](https://ai-release.org/guides/kak-ustanovit-i-nastroit-oh-my-pi-omp-konsolnyy-ii-agen.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

## FAQ

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

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

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

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