pi
Добавлено: 03 окт 2026, 04:29
Спасибо, теперь я вижу, что **Pi — это минимальный agent harness (каркас агента)**, поддерживающий 15+ провайдеров, включая **Ollama** для локальных моделей. Нужна документация по конфигурации профилей.
Отлично! Нашёл информацию про профили. Теперь вижу, что есть пакет **pi-profiles** для управления профилями. Давайте получим ещё информацию о локальных моделях и настройке Ollama.
Теперь я понимаю полную картину. Вот решение вашей проблемы:
## Использование локальной модели в Pi на Debian
**Ошибка "профиль не создан"** указывает на то, что пи ещё не инициализирована. Вот пошаговое решение:
### 1. **Установите Pi**
На Debian запустите:
```bash
curl -fsSL https://pi.dev/install.sh | sh
```
Или через npm (требует Node.js 22.19+):
```bash
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
```
Проверьте установку:
```bash
pi --version
```
### 2. **Инициализируйте конфигурацию (создайте профиль)**
Перейдите в папку, где хотите работать, и запустите Pi:
```bash
cd ~/my-project
pi
```
При первом запуске Pi автоматически создаст конфигурационную директорию `~/.pi/agent/` с необходимыми файлами (в том числе `settings.json` и `auth.json`).
### 3. **Настройте локальную модель через `models.json`**
Если вы используете **Ollama**, отредактируйте файл `~/.pi/agent/models.json`:
```bash
nano ~/.pi/agent/models.json
```
Добавьте конфигурацию для Ollama:
```json
{
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434/v1",
"api": "openai-completions",
"apiKey": "ollama",
"models": [
{ "id": "mistral:latest" },
{ "id": "neural-chat:latest" }
]
}
}
}
```
Замените `mistral:latest` и `neural-chat:latest` на модели, которые вы хотите использовать.
### 4. **Убедитесь, что Ollama запущена**
На Debian запустите Ollama:
```bash
ollama serve
```
Или проверьте, что сервис работает:
```bash
curl http://localhost:11434/api/tags
```
### 5. **Выберите модель в Pi**
Откройте Pi и введите команду:
```
/model
```
Нажимайте стрелки вверх/вниз, чтобы найти вашу модель Ollama, затем нажмите `Enter`.
---
## Альтернатива: pi-profiles (для управления несколькими профилями)
Если позже вам понадобятся **несколько независимых профилей** (например, для разных проектов с разными моделями), установите **pi-profiles**:
```bash
npm install -g pi-profiles
```
Создайте профиль:
```bash
ppi create work --own-auth
ppi use work
```
Это создаст отдельную конфигурацию в `~/.pi/profiles/work/`.
---
## Файлы конфигурации
| Файл | Назначение |
|------|-----------|
| `~/.pi/agent/settings.json` | Общие настройки (тема, модель по умолчанию) |
| `~/.pi/agent/auth.json` | Сохранённые учётные данные провайдеров |
| `~/.pi/agent/models.json` | Кастомная конфигурация моделей (Ollama, LM Studio и т.д.) |
| `~/.pi/agent/sessions/` | Сохранённые сессии |
---
Когда вы запустите Pi в следующий раз, профиль уже будет создан, и вы сможете использовать локальную модель. Какую именно локальную модель вы хотите использовать — Ollama, llama.cpp или что-то ещё?
Отлично! Нашёл информацию про профили. Теперь вижу, что есть пакет **pi-profiles** для управления профилями. Давайте получим ещё информацию о локальных моделях и настройке Ollama.
Теперь я понимаю полную картину. Вот решение вашей проблемы:
## Использование локальной модели в Pi на Debian
**Ошибка "профиль не создан"** указывает на то, что пи ещё не инициализирована. Вот пошаговое решение:
### 1. **Установите Pi**
На Debian запустите:
```bash
curl -fsSL https://pi.dev/install.sh | sh
```
Или через npm (требует Node.js 22.19+):
```bash
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
```
Проверьте установку:
```bash
pi --version
```
### 2. **Инициализируйте конфигурацию (создайте профиль)**
Перейдите в папку, где хотите работать, и запустите Pi:
```bash
cd ~/my-project
pi
```
При первом запуске Pi автоматически создаст конфигурационную директорию `~/.pi/agent/` с необходимыми файлами (в том числе `settings.json` и `auth.json`).
### 3. **Настройте локальную модель через `models.json`**
Если вы используете **Ollama**, отредактируйте файл `~/.pi/agent/models.json`:
```bash
nano ~/.pi/agent/models.json
```
Добавьте конфигурацию для Ollama:
```json
{
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434/v1",
"api": "openai-completions",
"apiKey": "ollama",
"models": [
{ "id": "mistral:latest" },
{ "id": "neural-chat:latest" }
]
}
}
}
```
Замените `mistral:latest` и `neural-chat:latest` на модели, которые вы хотите использовать.
### 4. **Убедитесь, что Ollama запущена**
На Debian запустите Ollama:
```bash
ollama serve
```
Или проверьте, что сервис работает:
```bash
curl http://localhost:11434/api/tags
```
### 5. **Выберите модель в Pi**
Откройте Pi и введите команду:
```
/model
```
Нажимайте стрелки вверх/вниз, чтобы найти вашу модель Ollama, затем нажмите `Enter`.
---
## Альтернатива: pi-profiles (для управления несколькими профилями)
Если позже вам понадобятся **несколько независимых профилей** (например, для разных проектов с разными моделями), установите **pi-profiles**:
```bash
npm install -g pi-profiles
```
Создайте профиль:
```bash
ppi create work --own-auth
ppi use work
```
Это создаст отдельную конфигурацию в `~/.pi/profiles/work/`.
---
## Файлы конфигурации
| Файл | Назначение |
|------|-----------|
| `~/.pi/agent/settings.json` | Общие настройки (тема, модель по умолчанию) |
| `~/.pi/agent/auth.json` | Сохранённые учётные данные провайдеров |
| `~/.pi/agent/models.json` | Кастомная конфигурация моделей (Ollama, LM Studio и т.д.) |
| `~/.pi/agent/sessions/` | Сохранённые сессии |
---
Когда вы запустите Pi в следующий раз, профиль уже будет создан, и вы сможете использовать локальную модель. Какую именно локальную модель вы хотите использовать — Ollama, llama.cpp или что-то ещё?