Обновления, место на диске, порядок диагностики и таблица «симптом — причина — решение». Плюс вся книга одной страницей.
| Как часто | Что делать |
|---|---|
| Каждый раз перед задачей | Коммит в рабочей папке |
| Раз в неделю | Проверить свободное место на диске |
| Раз в месяц | ollama list, удалить неиспользуемые модели |
| Раз в месяц | Обновить движок и агента |
| Раз в 2–3 месяца | Скачать свежую версию основной модели |
| Раз в 2–3 месяца | Посмотреть, не вышло ли что-то лучше в вашей весовой категории |
| Постоянно | Проверять, что резервная копия делается |
# Ollama через brew brew upgrade ollama # Приложением — просто скачать свежую версию с сайта # Модели ollama pull qwen2.5:14b # Агент в окружении Python source ~/ai-agent/venv/bin/activate pip install --upgrade open-interpreter aider-chat
# Ollama winget upgrade Ollama.Ollama # Модели ollama pull qwen2.5:14b # Агент cd $HOME\ai-agent; .\venv\Scripts\Activate.ps1 pip install --upgrade open-interpreter aider-chat
Обновление движка иногда меняет поведение, а обновление агента — формат настроек. Обновляйтесь, когда есть время разобраться, а не за полчаса до дела. И не обновляйте движок и агента в один день — иначе непонятно, что сломалось.
df -h / du -sh ~/.ollama/models ollama list
Get-PSDrive C | Select-Object Used, Free ollama list
# Удалить модель ollama rm qwen2.5:3b # Python-окружение целиком (потом создать заново) # macOS: rm -rf ~/ai-agent/venv # Windows: Remove-Item -Recurse $HOME\ai-agent\venv
Когда «перестало работать», не переустанавливайте всё. Идите по слоям из главы 02 снизу вверх — это занимает две минуты и почти всегда сразу даёт ответ.
| Шаг | Проверка | Если не прошло |
|---|---|---|
| 1 | Движок запущен? Значок в меню или трее | Запустить Ollama |
| 2 | curl .../api/tags отвечает? | Перезапустить Ollama, потом компьютер |
| 3 | Модель на месте? ollama list | ollama pull |
| 4 | Модель отвечает? ollama run | Проблема с моделью — скачать заново |
| 5 | Адрес /v1 отвечает? | Обновить Ollama |
| 6 | Агент запускается? | Активировать окружение Python |
| 7 | Агент видит модель? | Сверить имя модели и адрес посимвольно |
До шага 5 проблема почти никогда не в агенте. Люди переустанавливают агента, а у них просто не запущен движок или окно терминала открыто без активированного окружения.
| Симптом | Причина | Решение |
|---|---|---|
| Команда не найдена | Окружение не активировано или путь не подхватился | Активировать venv; открыть терминал заново |
| Connection refused | Движок не запущен | Запустить Ollama |
| model not found | Имя не совпадает | Скопировать точно из ollama list |
| Очень медленно | Модель не влезла в память | ollama ps; взять модель меньше |
| Было быстро, стало медленно | Память занята другими программами | Закрыть лишнее; проверить ollama ps |
| Агент зацикливается | Слабая модель или мало контекста | Модель крупнее; увеличить контекст |
| Ломает формат вызовов | Модель мала или пережата | Крупнее либо менее сжатая |
| Забывает начало задачи | Кончился контекст | Увеличить контекст; дробить задачи |
| Правки не применяются | Неверный префикс модели у Aider | ollama_chat/, а не ollama/ |
| После обновления сломалось | Изменился формат настроек | Сверить настройки с документацией версии |
| Кончилось место | Накопились модели | ollama rm лишние |
| Ноутбук перегревается | Нормально под нагрузкой | В розетку; модель меньше; перерывы |
Порядок именно такой: от самого дешёвого к самому долгому.
| Этап | Что сделать | Главы |
|---|---|---|
| Оценить | Посчитать память, понять свой потолок по модели | 03 |
| Выбрать маршрут | А, Б, В или Г | 04 |
| Поставить движок | Ollama или LM Studio | 05–07 |
| Проверить | Четыре проверки по слоям | 08 |
| Выбрать модель | Размер, сжатие, специализация | 09–11 |
| Поставить агента | Одного. Начать с Aider | 12–17 |
| Обезопасить | Копии, git, отдельная папка, без админа | 18–20 |
| Работать | По одной задаче, с ограничениями в формулировке | 21–22 |
| Дополнять | Облако для сложного, локально для своего | 23 |
| Поддерживать | Обновления, диск, диагностика по слоям | 24 |
Локальный агент — не замена вашей голове и не волшебство. Это ускоритель для рутины, которую вы и так умеете делать, работающий на вашем железе, без подписок и без отправки ваших файлов наружу. Он будет ошибаться — и в этом нет проблемы ровно до тех пор, пока цена ошибки равна одной команде отката. Настройте эту цену один раз, и дальше можно спокойно экспериментировать.
Бесплатная книга · tariel.ge · команды и версии проверяйте в официальной документации проектов
Книга бесплатна для чтения. Автор — Тариел Бежанидзе, компьютерный мастер в Батуми · tariel.ge · все бесплатные книги. Копировать текст целиком на другие сайты — только со ссылкой на источник.