gptme

/ʤiː piː tiː miː/
_{что это значит?}

Начало работы • Загрузки • Веб-сайт • Документация

📜 Персональный ИИ-агент, работающий везде, где есть терминал — на вашем ноутбуке, ssh-сессиях, в tmux, на серверах без графического интерфейса, в пайплайнах CI.
Работает с любыми провайдерами, приоритет локального выполнения, без ограничений: включает shell, Python, веб, видение и всё остальное, что требуется агенту.
Отличный кодирующий агент, но достаточно универсальный для помощи в любом интеллектуальном труде.

Бесплатный и с открытым исходным кодом. Работает с Anthropic, OpenAI, Google, xAI, DeepSeek, OpenRouter или полностью локально через llama.cpp — ваши данные, ваши модели, ваш терминал.
Мощная альтернатива Claude Code, Codex, Cursor и Warp — один из первых агентных CLI (весна 2023), всё ещё в очень активной разработке.

📚 Содержание

• 📢 Новости
• 🎥 Демо
• 🌟 Возможности
• 🛠 Инструменты
• 🔌 Расширяемость: плагины, навыки и уроки
• 🔗 Интеграции: MCP и ACP
• 🤖 Автономные агенты
• 🛡 Защитные механизмы
• 🛠 Примеры использования
• 🛠 Преимущества для разработчиков
• 🚧 В разработке
• 🚀 Начало работы
• 🛠 Использование
• 🌍 Экосистема
• 💬 Сообщество
• 📊 Статистика
• 🔗 Ссылки

📢 Новости

• Скоро будет - сервис gptme.ai для запуска агентов в облаке; приложение gptme desktop для удобного локального использования.
• 2026-01 - gptme-agent-template v0.4: Bob широко работал как автономный агент, автономные циклы запусков, улучшенная генерация контекста
• 2025-12 - v0.31.0: Фоновые задачи, инструмент форм, отслеживание затрат, контентно-адресуемое хранилище
• 2025-11 - v0.30.0: Система плагинов, сжатие контекста, режим планировщика подагентов
• 2025-10 - v0.29.0: Система уроков для контекстной помощи, обнаружение и динамическая загрузка MCP, осведомлённость о токенах; Bob начинает автономные запуски с мониторингом GitHub
• 2025-08 - v0.28.0: Поддержка MCP, инструмент morph для быстрых редактирований, автосохранение, переработанный серверный API
• 2025-03 - v0.27.0: Интеграция с pre-commit, использование компьютера на macOS, Claude 3.7 Sonnet, DeepSeek R1, локальный TTS с Kokoro
• 2025-01 - Создан gptme-contrib:_community-плагины, включая Twitter/X, Discord-бот, инструменты для почты, консорциум (мультиагентные)
• 2024-12 - gptme-agent-template v0.3: Шаблон для постоянных агентов
• 2024-11 - Расширение экосистемы: gptme-webui, gptme-rag, gptme.vim, создан Bob (первый автономный агент)
• 2024-10 - Первый вирусный твит, привлёкий широкое внимание
• 2024-08 - Show HN, поддержка Anthropic Claude, инструмент tmux
• 2023-09 - Первый публичный релиз на HN, Reddit, Twitter
• 2023-03 - Первый коммит - один из первых агентных CLI

Подробнее об истории смотрите на страницах Хронология и Журнал изменений.

🎥 Демонстрации

[!NOTE] Скринкасты ниже взяты из 2023 года. gptme с тех пор очень много развился! Для актуальных примеров и скриншотов смотрите Документацию. Мы работаем над автоматической генерацией демо: #1554.

Фибоначчи	Змейка с curses
**Шаги** Создать новую директорию 'gptme-test-fib' и инициировать git Написать функцию фибоначчи в fib.py, сделать коммит Создать публичный репозиторий и запушить на GitHub	**Шаги** Создать игру "змейка" с curses в snake.py Запуск не работает, попросить gptme исправить ошибку Игра запускается Попросить gptme добавить цвет Небольшие трудности Законченная игра с зелёной змейкой и красным яблочным пирогом!
Мандельброт с curses	Ответить на вопрос из URL
**Шаги** Отрисовать мандельброт с curses в mandelbrot_curses.py Программа запускается Добавить цвет	**Шаги** Спросить, кто является CEO Superuser Labs, передав URL сайта gptme посещает сайт и правильно отвечает
Терминальный интерфейс	Веб-интерфейс
**Возможности** Мощный терминальный интерфейс Удобные CLI-команды Diff и подсветка синтаксиса Автодополнение по Tab История команд	**Возможности** Общайтесь с gptme из вашего браузера Доступ ко всем инструментам и возможностям Современный, адаптивный интерфейс Возможность самостоятельного размещения Доступен на chat.gptme.org

Вы можете найти больше Демонстраций и Примеров в документации.

🌟 Возможности

• 💻 Выполнение кода
• Выполняет код в вашей локальной среде с помощью инструментов shell и python.
• 🧩 Чтение, запись и изменение файлов
• Вносит инкрементальные изменения с помощью инструмента patch.
• 🌐 Поиск и просмотр веб-страниц
• Может использовать браузер через Playwright с помощью инструмента browser.
• 👀 Зрение
• Может видеть изображения, на которые ссылаются в запросах, скриншоты вашего рабочего стола и веб-страницы.
• 🔄 Самокоррекция
• Выходные данные возвращаются ассистенту, позволяя ему реагировать и исправлять свои ошибки.
• 📚 Система уроков
• Контекстные инструкции и лучшие практики автоматически добавляются при релевантности.
• Сопоставление по ключевым словам, инструментам и паттернам.
• Адаптируется к интерактивным и автономным режимам.
• Расширяйте собственными уроками и навыками.
• 🤖 Поддержка многих провайдеров LLM
• Anthropic (Claude), OpenAI (GPT), Google (Gemini), xAI (Grok), DeepSeek и другие.
• Используйте OpenRouter для доступа к 100+ моделям или разверните локально с llama.cpp.
• Выбирайте нужную модель для каждой задачи — быстрые/дешёвые для триажа, мощные для написания кода.
• 🌐 Веб-интерфейс и REST API
• Современный веб-интерфейс на chat.gptme.org (gptme-webui)
• Простой встроенный веб-интерфейс включён в Python-пакет.
• Сервер с REST API.
• Доступны автономные сборки с помощью PyInstaller.
• 💻 Использование компьютера (см. #216)
• Даёт ассистенту доступ к полному рабочему столу, позволяя взаимодействовать с GUI-приложениями.
• 🧠 Интеллект кода
• Структурное понимание кода с помощью gptme-codegraph: графы вызовов, извлечение символов и анализ влияния, реализованные на Tree-sitter. Девять инструментов MCP для навигации по кодовой базе.
• 🔊 Звуки инструментов — приятные звуки уведомлений для различных операций инструментов.
• Включается через GPTME_TOOL_SOUNDS=true.

🛠 Инструменты

gptme снабжает ИИ богатым набором встроенных инструментов:

Используйте /tools во время разговора, чтобы увидеть все доступные инструменты и их статус.

🔌 Расширяемость: Плагины, Навыки и Уроки

gptme имеет многоуровневую систему расширяемости, которая позволяет адаптировать его под ваш рабочий процесс:

Плагины — расширяют gptme пользовательскими инструментами, хуками и командами через Python-пакеты:

# gptme.toml
[plugins]
paths = ["~/.config/gptme/plugins", "./plugins"]
enabled = ["my_plugin"]

Навыки — лёгкие пакеты рабочих процессов (в формате Anthropic), которые автоматически загружаются при упоминании по имени. Идеально подходят для упаковки многоразовых инструкций и вспомогательных скриптов без написания Python.

Уроки — контекстные инструкции, которые автоматически вставляются в разговоры на основе ключевых слов, инструментов и паттернов. Создавайте собственные, чтобы запечатлеть лучшие практики команды или доменные знания.

Хуки — запускают пользовательский код на ключевых этапах жизненного цикла (до/после вызова инструментов, при начале разговора и т.д.) без необходимости создания полноценного плагина.

gptme-contrib —.community-вклад в виде плагинов, пакетов, скриптов и уроков:

🛡 Ограничения

Для постоянных агентов необходимы ограничения на весь цикл, а не только на разрешения инструментов:

• Входные ограничения — структурированные селекторы задач в рабочем пространстве агента удерживают фокус работы и снижают переключения на уведомления или неоднозначные задачи. Bob использует селектор стиля CASCADE для этого уровня.
• Ограничения перед действием — уроки вводят ситуативные рекомендации перед тем, как агент действует.
• Выходные ограничения — хуки и проверки перед коммитом проверяют изменения файлов перед возвращением управления пользователю.

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

🛠 Использование

$ gptme --help
Usage: gptme [OPTIONS] [PROMPTS]...

  gptme — это чат-интерфейс для LLM, наделяющий их инструментами для запуска
  команд shell, выполнения кода, чтения и манипулирования файлами и многого другого.

  Если указаны PROMPTS, будет начат новый разговор с ними. PROMPTS можно
  объединять с помощью разделителя '-'.

  Интерфейс предоставляет пользовательские команды для взаимодействия
  с системой.

  Доступные команды:
    /undo         Отменить последнее действие
    /log          Показать журнал разговора
    /edit         Редактировать разговор в вашем редакторе
    /rename       Переименовать разговор
    /fork         Создать копию разговора
    /summarize    Резюмировать разговор
    /replay       Воспроизвести операции инструментов
    /export       Экспортировать разговор как HTML
    /model        Показать или переключить текущую модель
    /models       Вывести список доступных моделей
    /tokens       Показать использование токенов и стоимость
    /context      Показать разбивку токенов контекста
    /tools        Показать доступные инструменты
    /commit       Попросить ассистента сделать git коммит
    /compact      Сжать разговор
    /impersonate  Имитировать ассистента
    /restart      Перезапустить процесс gptme
    /setup        Настроить gptme
    /help         Показать это справочное сообщение
    /exit         Выйти из программы

  Все команды смотрите в документации: https://gptme.org/docs/commands.html

  Горячие клавиши:
    Ctrl+X Ctrl+E  Редактировать запрос в вашем редакторе
    Ctrl+J         Вставить новую строку без выполнения запроса

Options:
  --name TEXT            Название разговора. По умолчанию генерируется случайное
                         имя.
  -m, --model TEXT       Модель для использования, например openai/gpt-5, anthropic/claude-
                         sonnet-4-20250514. Если указан только провайдер, то
                         используется модель по умолчанию.
  -w, --workspace TEXT   Путь к каталогу рабочей области. Передайте '@log' для создания
                         рабочей области в каталоге журнала.
  --agent-path TEXT      Путь к каталогу рабочей области агента.
  -r, --resume           Загрузить самый последний разговор.
  -y, --no-confirm       Пропустить все запросы подтверждения.
  -n, --non-interactive  Неинтерактивный режим. Подразумевает --no-confirm.
  --output-format [text|json]
                         Формат вывода для неинтерактивного режима. 'json'
                         выводит один JSON-объект на строку в stdout.
  --system TEXT          Системный запрос. Варианты: 'full', 'short' или что-то
                         пользовательское.
  -t, --tools TEXT       Разрешенные инструменты через запятую. Доступные:
                         append, browser, chats, choice, computer, gh,
                         ipython, morph, patch, rag, read, save, screenshot,
                         shell, subagent, tmux, vision.
  --tool-format TEXT     Формат инструментов. Варианты: markdown, xml, tool
  --no-stream            Не транслировать ответы
  --show-hidden          Показывать скрытые системные сообщения.
  -v, --verbose          Показывать подробный вывод.
  --version              Показать информацию о версии и конфигурации
  --help                 Показать это сообщение и выйти.

Используйте --non-interactive в паре с --output-format json, когда stdout должен быть машиночитаемым, например, в CI или процессе-супервизоре. Используйте --resume, чтобы продолжить существующий автоматизированный разговор или взять из очереди отложенные запросы без передачи нового промпта.

🌍 Экосистема

gptme — это больше, чем CLI — это платформа с растущей экосистемой:

Агенты сообщества на базе gptme: - Bob — автономный ИИ-агент, непрерывно работающий с конца 2024 года, вносит вклад в открытые проекты и управляет своими задачами - Alice — персональный ассистент и оркестратор агентов, форкнутый из той же архитектуры

💬 Сообщество

• Discord — задавайте вопросы, делитесь тем, что вы создали, обсуждайте функции
• GitHub Discussions — более длинные беседы и идеи
• X/Twitter — обновления и объявления

Приветствуются вклады! Смотрите руководство по участию.

📊 Статистика

⭐ Звездочки со временем

📈 Статистика загрузок

• PePy
• PyPiStats

🔗 Ссылки

• Веб-сайт
• Документация
• GitHub
• Discord

❓ Часто задаваемые вопросы

Что такое gptme?

gptme — это персональный ИИ-агент, работающий там, где есть терминал — на вашем ноутбуке, в сессиях SSH, tmux, безголовых серверах, в пайплайнах CI. Он независим от провайдеров, работает преимущественно локально и не ограничен: поставляется с shell, Python, вебом, зрением и всем остальным, что необходим агенту. Произносится /ʤiː piː tiː miː/, как "Джи-Пи-Ти-Ми".

Как gptme сравнивается с другими ИИ-ассистентами для кода?

Как установить gptme?

Предварительные требования: Python 3.10+

Установка:

pip install gptme
# или
pipx install gptme

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

gptme

Какие ИИ-провайдеры поддерживает gptme?

gptme поддерживает несколько ИИ-провайдеров:

Как использовать локальные модели?

Используйте llama.cpp для полностью локальной работы:

1. Запустите сервер llama.cpp:

llama-server --model ./models/llama-3.gguf --port 8080

1. Настройте gptme:

export OPENAI_BASE_URL=http://localhost:8080/v1
gptme -m local/<имя-модели>

Какие инструменты есть в gptme?

gptme поставляется с комплексными инструментами:

• shell: Выполнение команд в терминале
• python: Запуск кода на Python
• patch: Поэтапное редактирование файлов
• browser: Просмотр веба через Playwright
• vision: Обработка изображений/скриншотов
• tmux: Управление сессиями tmux
• morph: Быстрые преобразования файлов
• form: Интерактивные формы
• mcp: Обнаружение и использование инструментов MCP

Как работает интеграция с MCP?

gptme имеет встроенную поддержку MCP:

• Обнаружение MCP: Автоматически обнаруживает серверы MCP
• Динамическая загрузка: Загружает инструменты MCP по требованию
• Интеграция инструментов: Инструменты MCP работают как встроенные инструменты

Примеры поддерживаемых серверов MCP: - gptme-codegraph — структурный анализ графа кода с tree-sitter (9 инструментов) - GitHub MCP - Puppeteer MCP - SQLite MCP - Пользовательские серверы MCP

Что такое система «Уроки»?

Система «Уроки» предоставляет контекстные рекомендации и лучшие практики, которые автоматически включаются при необходимости:

• Уроки для проекта: Пользовательские рекомендации для вашего проекта
• Лучшие практики: Паттерны кодирования и соглашения
• Внедрение контекста: Автоматический контекст в зависимости от ситуации

Как создать автономных агентов?

Используйте gptme-agent-template для создания постоянных автономных агентов:

1. Клонируйте шаблон:

git clone https://github.com/gptme/gptme-agent-template

1. Настройте агента:

# config.yaml
name: "МойАгент"
role: "Ревьюер кода"
schedule: "часовой"

1. Запустите:

python agent.py

Смотрите пример Bob — автономного агента, который непрерывно работает с конца 2024 года.

Что такое система плагинов?

gptme имеет полную систему плагинов:

• Навыки: Пользовательские инструменты и возможности
• Хуки: Пред-/пост-выполнительные хуки
• Интеграции: Коннекторы к внешним сервисам
• Плагины сообщества: Репозиторий gptme-contrib

Примеры плагинов: - Бот для Twitter/X - Бот для Discord - Почтовые инструменты - Консорциум (мультиагентный)

Как использовать gptme в CI/CD?

gptme запускается в CI-пайплайнах:

# GitHub Actions
- name: Запуск gptme
  run: |
    pip install gptme
    gptme --non-interactive "Проверь PR и предложи улучшения"

Каковы варианты использования?

gptme — универсальный инструмент, но особенно хорош для:

• Кодирования: Написание, рефакторинг, отладка кода
• Исследований: Просмотр веба, сбор данных
• Автоматизации: Управление файлами, задачи CI
• Документации: Генерация документации, резюме
• Тестирования: Написание тестов, запуск тестов, исправление ошибок
• DevOps: Управление серверами, развертывание

Как настроить gptme?

Настройка через переменные окружения:

# Выбор провайдера
export GPTME_MODEL=anthropic/claude-sonnet-4-6

# Ключи API
export ANTHROPIC_API_KEY=ваш-ключ

# Уровень логирования
export GPTME_LOG_LEVEL=INFO

Как обрабатывать ошибки?

gptme имеет автокоррекцию:

• Вывод подается обратно ассистенту
• Автоматический повтор при ошибках
• Вмешательство пользователя при необходимости

Где найти дополнительные ресурсы?

• Сайт: gptme.org
• Документация: docs.gptme.org
• Примеры: Примеры
• Загрузки: Загрузки
• Discord: Сообщество Discord
• Twitter: @gptmeorg

Удачного создания терминальных агентов! 🤖