gptme-agent-template

[!NOTE] Это шаблон агента на основе gptme. См. документацию по агентам для получения дополнительной информации о gptme-агентах и их работе.

Создайте форк, чтобы создать нового агента с собственной идентичностью.

Имя агента — gptme-agent.

Этот git-репозиторий является мозгом gptme-agent. Это рабочее пространство для его мыслей и идей.

• gptme-agent будет записывать свои мысли, планы и идеи в этом репозитории.
• Инфраструктура агента gptme-agent, включая этот репозиторий, находится в разработке.
• gptme-agent поощряется предлагать улучшения своей инфраструктуры.

Информация о gptme-agent содержится в ABOUT.md, включая его личность и цели. Персональные данные gptme-agent — голос, вкус и позиция — находятся в SOUL.md, который поддерживается кратким и информативным. Информация об инфраструктуре и архитектуре gptme-agent содержится в ARCHITECTURE.md.

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

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

Быстрая проверка:

./scripts/install-deps.sh

Автоустановка (где возможно):

./scripts/install-deps.sh --install

Необходимые зависимости

Рекомендуемые зависимости

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

Самый простой способ создать нового агента из этого шаблона — использовать CLI gptme-agent (входит в состав gptme):

pipx install gptme

# Create a new agent workspace from this template
gptme-agent create ~/my-agent --name MyAgent

cd ~/my-agent

# Run the agent interactively
gptme "hello"

Контекст агента автоматически загружается через gptme.toml, который настраивает файлы и команду контекста для включения.

Бэкенд Claude Code

Шаблон также поддерживает Claude Code в качестве альтернативного бэкенда:

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Authenticate
claude /login

# Run interactively (reads AGENTS.md automatically)
claude

# Run autonomously
./scripts/runs/autonomous/autonomous-run-cc.sh

Скрипт scripts/build-system-prompt.sh читает gptme.toml и создаёт системный промпт для Claude Code, поэтому оба бэкенда используют одни и те же файлы идентичности и контекст.

Проверка работоспособности рабочего пространства

После создания или форка рабочего пространства агента убедитесь, что всё настроено правильно:

gptme-agent doctor

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

Требуется gptme >= v0.32

Запустите агента в интерактивном режиме с помощью gptme или Claude Code:

gptme "hello"
# or: claude

Автономная работа

Агенты могут работать автономно по расписанию с помощью systemd (Linux) или launchd (macOS).

# Install as a system service (runs every 30 minutes by default)
gptme-agent install

# Customize the schedule
gptme-agent install --schedule "*:00"    # Every hour

# Manage the agent
gptme-agent status              # Check status
gptme-agent logs --follow       # Monitor logs
gptme-agent run                 # Trigger immediate run
gptme-agent stop                # Pause scheduled runs

См. документацию по gptme-агентам для получения команд установки и управления службами.

Чтобы настроить автономное поведение, отредактируйте скрипт запуска для вашего бэкенда: - gptme: scripts/runs/autonomous/autonomous-run.sh - Claude Code: scripts/runs/autonomous/autonomous-run-cc.sh

См.: scripts/runs/autonomous/README.md для полной документации.

Возможности: - Рабочий процесс CASCADE (Незакрытые вопросы → Выбор задачи → Выполнение) - Двухочередная система (ручные + сгенерированные приоритеты) - Защитные ограничения (классификация операций GREEN/YELLOW/RED) - Документация сессий и управление состоянием - Мульти-бэкенд: Поддерживает как gptme, так и Claude Code бэкенды

Форкинг (ручная альтернатива)

Если вы предпочитаете создать форк вручную вместо использования gptme-agent create:

git clone https://github.com/gptme/gptme-agent-template
cd gptme-agent-template
git submodule update --init --recursive

./scripts/fork.sh <path> [<agent-name>]

Затем следуйте инструкциям в выводе.

Доменные агентские приложения

Используйте knowledge/portable-agent-apps.md при упаковке доменного агентского приложения из этого шаблона. Краткая версия: сохраняйте единый контракт рабочего процесса, предоставляйте его через тонкие адаптеры выполнения и сохраняйте состояние, принадлежащее пользователю, при обновлениях системы.

Структура рабочего пространства

• gptme-agent отслеживает задачи в TASKS.md
• gptme-agent ведёт журнал в ./journal/
• gptme-agent хранит базу знаний в ./knowledge/

• gptme-agent ведёт профили людей в ./people/

• gptme-agent управляет приоритетами работы в ./state/ с помощью системы двух очередей (ручная + генерируемая)

• gptme-agent использует скрипты в ./scripts/ для генерации контекста, управления задачами и автоматизации
• gptme-agent может добавлять файлы в gptme.toml, чтобы всегда включать их в свой контекст

Ключевые каталоги

state/: Управление очередью работ - queue-manual.md - Рабочая очередь, поддерживаемая вручную, со стратегическим контекстом - queue-generated.md - Автоматически генерируемая очередь из задач и GitHub - См. state/README.md для подробной документации

scripts/: Автоматизация и утилиты - context.sh - Основной оркестратор генерации контекста - gptodo - CLI для управления задачами (установка из gptme-contrib)

• runs/autonomous/ - Инфраструктура автономной работы

• См. scripts/README.md для полной документации

lessons/: Поведенческие паттерны и ограничения - Предотвращает известные режимы отказов с помощью структурированных рекомендаций - См. lessons/README.md для документации системы уроков