gptme

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

Начало работы • Документация • Дорожная карта • Цены

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

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

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

📢 Новости

• 2026-07 - ... Десктопное приложение для Linux (AppImage), macOS и Windows с автоматической установкой обновлений — [скачать ... gptme.ai облачный сервис
• 2026-01 - ... v0.4: ... активно использовался как автономный агент, автономные циклы выполнения, улучшенное создание контекста
• 2025-12 - ... Фоновые задания, инструмент форм, отслеживание затрат, хранилище с адресацией по содержимому
• 2025-11 - ... Система плагинов, сжатие контекста, режим планировщика суб-агентов
• 2025-10 - ... Система уроков для контекстуального руководства, обнаружение и динамическая загрузка MCP, осведомлённость о токенах; ... начинает автономные запуски с мониторингом GitHub
• 2025-08 - ... Поддержка MCP, инструмент морфа для быстрого редактирования, авто-коммит, переработанный серверный API
• 2025-03 - ... Интеграция pre-commit, использование компьютера macOS, Claude 3.7 Sonnet, DeepSeek R1, локальный TTS с Kokoro
• 2025-01 - ... созданы: плагины сообщества, включая Twitter/X, Discord-бота, инструменты для электронной почты, консорциум (мульти-агент)
• 2024-12 - ... v0.3: Шаблон для постоянных агентов
• 2024-11 - Ecosystem expansion: gptme-webui, gptme-rag, gptme.vim, Bob created (first autonomous agent)
• 2024-10 - First viral tweet bringing widespread attention
• 2024-08 - Show HN, Anthropic Claude support, tmux tool
• 2023-09 - Initial public release on HN, Reddit, Twitter
• 2023-03 - Initial commit - one of the first agent CLIs

For more history, see the Timeline and Changelog.

🎥 Demos

[!NOTE] The screencasts below are from 2023. gptme has evolved a lot since then! For up-to-date examples and screenshots, see the Documentation. We're working on automated demo generation: #1554.

Fibonacci	Snake with curses
**Steps** Create a new dir 'gptme-test-fib' and git init Write a fib function to fib.py, commit Create a public repo and push to GitHub	**Steps** Create a snake game with curses to snake.py Running fails, ask gptme to fix a bug Game runs Ask gptme to add color Minor struggles Finished game with green snake and red apple pie!
Mandelbrot with curses	Answer question from URL
**Steps** Render mandelbrot with curses to mandelbrot_curses.py Program runs Add color	**Steps** Ask who the CEO of Superuser Labs is, passing website URL gptme browses the website, and answers correctly
Terminal UI	Web UI
**Features** Powerful terminal interface Convenient CLI commands Diff & Syntax highlighting Tab completion Command history	**Features** Chat with gptme from your browser Access to all tools and features Modern, responsive interface Self-hostable Available at chat.gptme.org

You can find more Demos and Examples in the documentation.

🌟 Features

• 💻 Code execution
  • Executes code in your local environment with the shell and python tools.
• 🧩 Read, write, and change files
  • Makes incremental changes with the patch tool.
• 🌐 Search and browse the web
  • Can use a browser via Playwright with the browser tool.
• 👀 Vision
  • Can see images referenced in prompts, screenshots of your desktop, and web pages.
• 🔄 Self-correcting
  • Output is fed back to the assistant, allowing it to respond and self-correct.
• 📚 Lessons system
  • Contextual guidance and best practices automatically included when relevant.
  • Keyword, tool, and pattern-based matching.
  • Adapts to interactive vs autonomous modes.
  • Extend with your own lessons and skills.

• 🤖 Поддержка множества LLM поставщиков
  • Anthropic (Claude), OpenAI (GPT), Google (Gemini), xAI (Grok), DeepSeek и другие.
  • Используйте OpenRouter для доступа к 100+ моделям или разверните локально с помощью llama.cpp.
  • Принесите свою подписку: используйте существующий ChatGPT Plus/Pro или SuperGrok вместо ключей API (см. поставщики).
  • [Выберите подходящую модель — быструю/дешёвую для триажа, мощную для кодинга.
• 🌐 Веб-интерфейс и REST API
  • Современный gptme-webui, встроенный в gptme-server и размещённый на ...
  • Сервер с REST API.
  • Доступны автономные исполняемые сборки с помощью PyInstaller.
• 💻 Использование компьютера (см. ...
  • Предоставьте помощнику доступ к полному рабочему столу, позволяя взаимодействовать с GUI-приложениями.
• 🧠 Кодовая интеллектуальность
  • Структурное понимание кода с помощью gptme-codegraph: графы вызовов, извлечение символов и анализ влияния, работающие на основе Tree-sitter. Девять инструментов MCP для навигации по кодовой базе.
• 🔊 Звуки инструментов — приятные звуковые уведомления для различных операций инструментов.
  • Включите с ...

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

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

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

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

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

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

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

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

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

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

gptme-contrib — плагины, пакеты, скрипты и уроки, созданные сообществом:

🔗 Интеграции: MCP & ACP

MCP (Model Context Protocol) — используйте любой сервер MCP в качестве источника инструментов:

pipx install gptme  # MCP support included by default

gptme может обнаруживать и динамически загружать серверы MCP, предоставляя агенту доступ к базам данных, API, файловым системам и любым другим инструментам, совместимым с MCP. См. документацию MCP для настройки сервера.

ACP (Agent Client Protocol) — используйте gptme как агента для кодинга напрямую из вашего редактора:

pipx install 'gptme[acp]'

Это делает gptme доступным как заменяемый инструмент для кодинга в Zed и IDE JetBrains. Ваш редактор отправляет запросы, gptme выполняет их с полным набором инструментов (shell, браузер, файлы и т.д.) и возвращает результаты обратно.

🤖 Автономные агенты

gptme предназначен не только для интерактивного использования, но и для работы как постоянный автономный агент — ИИ, который работает непрерывно, запоминает всё и улучшается со временем. gptme-agent-template предоставляет полный каркас:

• Постоянное рабочее пространство — git-отслеживаемый "мозг" с журналом, задачами, базой знаний и уроками
• Циклы выполнения — запланированные (systemd/launchd) или событийно-ориентированные автономные операции
• Управление задачами — очередь задач с YAML-метаданными и рабочими процессами в стиле GTD
• Метаобучение — система уроков фиксирует поведенческие паттерны и улучшает работу со временем
• Координация между агентами — аренда файлов, шина сообщений и распределение работы для параллельных агентов
• Внешние интеграции — GitHub, email, Discord, Twitter, RSS и другие

# Create and run your own agent
gptme-agent create ~/my-agent --name MyAgent
gptme-agent install   # runs on a schedule
gptme-agent status    # check on it

Автономные агенты в фоновом режиме с systemd

Для быстрой настройки gptme-агента как постоянного systemd-сервиса на любой Linux-машине используйте gptme service init:

# Generate a complete headless agent setup
gptme service init --name my-agent --model gpt-4o-mini --work-dir ~/my-agent

# Install and start on a daily timer
systemctl --user daemon-reload
systemctl --user enable --now my-agent.timer

# Update the schedule (--force overwrites all generated files, including gptme.toml and startup script)
gptme service init --name my-agent --work-dir ~/my-agent --timer-schedule hourly --force

Эта команда создаёт: - systemd-юнит сервиса — запускает вашего агента в пользовательской сессии - Необязательный таймер — планирует автономные запуски (ежечасно, ежедневно, еженедельно или по требованию) - Скрипт запуска — выполняет одну неинтерактивную сессию gptme по каждому триггеру и записывает постоянную запись в журнал - Промпт сессии — prompt.md, инструкция, которую агент выполняет при каждом запуске - Шаблон конфигурации — gptme.toml и AGENTS.md, готовые к настройке

Созданное рабочее пространство самостоятельно и работает "из коробки" — отредактируйте prompt.md, чтобы указать, что должен делать агент при каждом запуске; вам нужно только установить gptme. Идеально подходит для автоматизации, мониторинга, оркестрации CI/CD или запуска фоновых агентов на серверах без графического интерфейса.

См. [Headless Agents ... для расширенных конфигураций и устранения неполадок.

... является эталонной реализацией — производственным автономным агентом, работающим непрерывно с конца 2024 года. Боб открывает PR, проверяет код, исправляет CI, управляет своей очередью задач, поддерживает растущий набор уроков, публикует в [блоге ... отвечает в Discord и пишет [блог ...

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

См. [Autonomous Agents ... для полного руководства.

🛡 Ограничители

Постоянным агентам нужны ограничители на всём цикле, а не только на уровне разрешений инструментов:

• Ограничители ввода — структурированные селекторы задач в рабочем пространстве агента помогают сосредоточиться на работе и снижают "дрожание" на уведомлениях или нечётких задачах. Боб использует селектор в стиле CASCADE для этого уровня.
• Ограничители перед действием — уроки вводят ситуационные рекомендации перед тем, как агент действует.
• Ограничители вывода — хуки и [pre-commit ... проверяют изменения файлов перед возвратом управления пользователю.

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

🛠 Применение

• 🖥 Разработка: Пишите и запускайте код быстрее с помощью ИИ-помощи.
• 🎯 Эксперт по shell: Получайте нужную команду, используя естественный язык (больше не нужно запоминать флаги!).
• 📊 Анализ данных: Обрабатывайте и анализируйте данные прямо в вашем терминале.
• 🎓 Интерактивное обучение: Экспериментируйте с новыми технологиями или кодовыми базами на практике.
• 🤖 Агенты и инструменты: Создавайте долгосрочных автономных агентов для реальной работы.
• 🔬 Исследования: Автоматизируйте обзор литературы, сбор данных и аналитические конвейеры.

🛠 Преимущества для разработчиков

• ⭐ Один из первых CLI-агентов, созданных (весна 2023 года), который всё ещё находится в активной разработке.
• 🧰 Легко расширяется
  • Большинство функций можно реализовать с помощью инструментов, хуков и команд.
  • Плагины позволяют легко упаковывать расширения.
  • Пытаемся оставаться минималистичными — минимальное ядро, расширяйте по мере необходимости.

• 🧪 Обширное тестирование, высокая покрытость.
• 🧹 Чистый код, проверенный и отформатированный с помощью mypy, ruff и pyupgrade.
• 🤖 GitHub Bot, чтобы запрашивать изменения из комментариев! (см. ...
  • Работает в этом репозитории! (см. ... в качестве примера)
  • Полностью работает в GitHub Actions.
• 📊 Набор оценок для тестирования возможностей разных моделей.
• 📝 gptme.vim для лёгкой интеграции с vim.

🚧 В процессе разработки

• 🖥 ... — десктопное приложение для Linux, macOS и Windows с автообновлениями ...
• ☁️ ... — управляемый облачный сервис для запуска агентов gptme (ранний доступ; всё ещё можно самостоятельно развернуть, запустив gptme-server + gptme-webui)
• 🌳 Древовидная структура диалога (см. ...
• 📜 RAG для автоматического включения контекста из локальных файлов (см. ...
• 🏆 Продвинутые оценки для тестирования граничных возможностей

🚀 Начало работы

Предварительные требования

• Python 3.10 или новее
• Учётные данные для хотя бы одного провайдера LLM:
  • OpenRouter можно настроить интерактивно с помощью /account setup openrouter внутри gptme, используя браузерную OAuth-онбординг.
  • Подписки тоже работают: войдите в систему с помощью вашего плана ChatGPT Plus/Pro или SuperGrok через gptme-auth openai-subscription или gptme-auth grok-subscription, API-ключ не нужен (см. документацию по провайдерам).
  • Вы также можете вручную установить API-ключи для ... ... ... (OPENAI_API_KEY), ... (OPENROUTER_API_KEY) и других провайдеров.
  • Локальные модели через llama.cpp не требуют ключа — см. документацию по провайдерам.

Установка

Для полных инструкций по настройке см. Руководство по началу работы.

# With pipx (recommended, requires Python 3.10+)
pipx install gptme

# With uv
uv tool install gptme

# With optional extras
pipx install 'gptme[browser]'  # Playwright for web browsing
pipx install 'gptme[all]'      # Everything

# Latest from git with all extras
uv tool install 'git+https://github.com/gptme/gptme.git[all]'

Быстрый старт

gptme

Вас встретит приглашение. Введите ваш запрос, и gptme ответит, используя необходимые инструменты.

Примеры команд

# Create a particle effect visualization
gptme 'write an impressive and colorful particle effect using three.js to particles.html'

# Generate visual art
gptme 'render mandelbrot set to mandelbrot.png'

# Get configuration suggestions
gptme 'suggest improvements to my vimrc'

# Process media files
gptme 'convert to h265 and adjust the volume' video.mp4

# Code assistance from git diffs
git diff | gptme 'complete the TODOs in this diff'

# Fix failing tests
make test | gptme 'fix the failing tests'

# Auto-approve tool confirmations (user can still watch and interrupt)
gptme -y 'run the test suite and fix any failing tests'

# Fully non-interactive/autonomous mode (no user interaction possible, safe for scripts/CI)
gptme -n 'run the test suite and fix any failing tests'

# Machine-readable automation output (JSONL on stdout)
gptme --non-interactive --output-format json 'summarize the current git diff'

Подробнее см. в Руководстве по началу работы и Примерах в документации.

⚙️ Конфигурация

Создайте ~/.config/gptme/config.toml:

[user]
name = "User"
about = "I am a curious human programmer."
response_preference = "Don't explain basic concepts"

[prompt]
# Additional files to always include as context
# files = ["~/notes/llm-tips.md"]

[env]
# Set your default model
# MODEL = "anthropic/claude-sonnet-4-20250514"
# MODEL = "openai/gpt-4o"

Для всех опций см. документацию по конфигурации.

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

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

  gptme is a chat-CLI for LLMs, empowering them with tools to run shell
  commands, execute code, read and manipulate files, and more.

  If PROMPTS are provided, a new conversation will be started with it. PROMPTS
  can be chained with the '-' separator.

  The interface provides user commands that can be used to interact with the
  system.

  Available commands:
    /undo         Undo the last action
    /log          Show the conversation log
    /edit         Edit the conversation in your editor
    /rename       Rename the conversation
    /fork         Create a copy of the conversation
    /summarize    Summarize the conversation
    /replay       Replay tool operations
    /export       Export conversation as HTML
    /model        Show or switch the current model
    /models       List available models
    /tokens       Show token usage and costs
    /context      Show context token breakdown
    /tools        Show available tools
    /commit       Ask assistant to git commit
    /compact      Compact the conversation
    /impersonate  Impersonate the assistant
    /restart      Restart gptme process
    /setup        Setup gptme
    /help         Show this help message
    /exit         Exit the program

  See docs for all commands: https://gptme.org/docs/commands.html

  Keyboard shortcuts:
    Ctrl+X Ctrl+E  Edit prompt in your editor
    Ctrl+J         Insert a new line without executing the prompt

Options:
  --name TEXT            Name of conversation. Defaults to generating a random
                         name.
  -m, --model TEXT       Model to use, e.g. openai/gpt-5, anthropic/claude-
                         sonnet-4-20250514. If only provider given then a
                         default is used.
  -w, --workspace TEXT   Path to workspace directory. Pass '@log' to create a
                         workspace in the log directory.
  --agent-path TEXT      Path to agent workspace directory.
  -r, --resume           Load most recent conversation.
  -y, --no-confirm       Skip all confirmation prompts.
  -n, --non-interactive  Non-interactive mode. Implies --no-confirm.
  --output-format [text|json]
                         Output format for non-interactive mode. 'json'
                         emits one JSON object per line on stdout.
  --system TEXT          System prompt. Options: 'full', 'short', or something
                         custom.
  -t, --tools TEXT       Tools to allow as comma-separated list. Available:
                         append, browser, chats, choice, computer, gh,
                         ipython, morph, patch, rag, read, save, screenshot,
                         shell, subagent, tmux, vision.
  --tool-format TEXT     Tool format to use. Options: markdown, xml, tool
  --no-stream            Don't stream responses
  --show-hidden          Show hidden system messages.
  -v, --verbose          Show verbose output.
  --version              Show version and configuration information
  --help                 Show this message and exit.

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

🌍 Экосистема

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

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

🏷️ Значок репозитория

Этот репозиторий поддерживается с помощью gptme. Чтобы показать, что ваш репозиторий поддерживается gptme, добавьте значок ниже.

<a href="https://gptme.org"><img src="https://gptme.org/badge.svg" alt="Built with gptme"></a>

💬 Сообщество

• Discord — задавайте вопросы, делитесь тем, что создали, обсуждайте функции
• **[GitHub ... — более длинные обсуждения и идеи
• ... — обновления и объявления Contributions welcome! See the contributing guide.

📊 Stats

⭐ Stargazers over time

📈 Download Stats

• PePy
• PyPiStats

🔗 Links

• Website
• Documentation
• GitHub
• Discord

❓ FAQ

What is gptme?

gptme is a personal AI agent that runs anywhere a terminal runs — your laptop, SSH sessions, tmux, headless servers, CI pipelines. It's provider-agnostic, local-first, and unconstrained: ships with shell, Python, web, vision, and everything else an agent needs. Pronounced /ʤiː piː tiː miː/ like "GPT-ME".

How does gptme compare to other AI coding assistants?

How do I install gptme?

Prerequisites: Python 3.10+

Installation:

pip install gptme
# or
pipx install gptme

First Run:

gptme

What AI providers does gptme support?

gptme supports multiple AI providers:

How do I use local models?

Use llama.cpp for fully local operation:

1. Start llama.cpp server:

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

1. Configure gptme:

export OPENAI_BASE_URL=http://localhost:8080/v1
gptme -m local/<model-name>

What tools does gptme have?

gptme ships with comprehensive tools:

• 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

Что такое система Lessons?

Система Lessons предоставляет контекстную помощь и рекомендации по лучшим практикам, которые автоматически включаются при релевантности:

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

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

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

1. Клонировать шаблон:

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

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

# config.yaml
name: "MyAgent"
role: "Code reviewer"
schedule: "hourly"

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

python agent.py

См. ... для примера автономного агента, работающего непрерывно с конца 2024 года.

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

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

• Навыки: Пользовательские инструменты и возможности
• Хуки: Хуки до/после выполнения
• Интеграции: Подключения к внешним сервисам
• Плагины сообщества: ... репозиторий

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

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

gptme работает в CI-конвейерах:

# GitHub Actions
- name: Run gptme
  run: |
    pip install gptme
    gptme --non-interactive "Review PR and suggest improvements"

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

gptme универсален, но особенно эффективен в:

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

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

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

# Provider selection
export GPTME_MODEL=anthropic/claude-sonnet-4-6

# API keys
export ANTHROPIC_API_KEY=your-key

# Logging level
export GPTME_LOG_LEVEL=INFO

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

gptme самокорректируется:

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

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

• Сайт: gptme.org
• Документация: ...
• Примеры: ...
• Загрузки: ...
• Discord: [Discord ...
• Twitter: ...

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