prime-agent README

The project's README from github.com/PrimeIntellect-ai/prime-agent. As one markdown file: README.md.

Prime Intellect

Prime Agent: A Self-Improving RLM Harness

Documentation • Verifiers • PRIME-RL

CI Build Binaries arXiv

PrimeIntellect-ai%2Fprime-agent | Trendshift

Prime Agent is an open-source coding and research agent for general and long-running work. It is designed around two core abstractions:

Prime Agent combines a persistent Python control environment with durable harness state, so useful working context and reusable operating patterns can outlive a single chat window.

Getting Started

Install the latest stable release on macOS or Linux:

curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | sh

The installer downloads a versioned release, verifies its SHA-256 checksum, installs the prime-agent command, and can prepare the Python runtime used by the agent.

Start Prime Agent from the repository or directory you want it to work in:

cd /path/to/project
prime-agent

On first launch, run /login to choose a subscription or API-key provider. Prime Agent works in the current directory and can run commands and modify files there. Use a disposable clone, clean worktree, or another checkpoint you can inspect and restore.

[!WARNING] Prime Agent executes model-generated Python and project commands with your user permissions. Its worker and kernel processes improve lifecycle isolation and recovery; they are not a security sandbox. Review changes and use trusted repositories, instructions, skills, and extensions only. Run untrusted code or instructions in an external sandbox or restricted environment.

Useful commands:

prime-agent agents                   # Browse running, idle, and saved sessions
prime-agent attach <agent>           # Reattach to a running session
prime-agent --resume [path|id]       # Browse sessions or resume one directly
prime-agent status                   # Inspect background service state
prime-agent doctor [--fix]           # Inspect or repair background services
prime-agent update [--force]         # Update Prime Agent
prime-agent shutdown [--force]       # Stop every agent, worker, and background service

Built for Long-Running Work

Prime Agent is built for long-running work, especially for evaluations in research. These features are available in the TUI, and when run autonomously.

Documentation

Contributing

Start with a GitHub Discussion for general questions, bug reports, and feature requests. Maintainers promote accepted work into Issues, and pull requests are reviewed from maintainers and vouched contributors.

Read the contribution guidelines for the full process. Report security vulnerabilities privately by following the security policy.

Acknowledgements

Our agent and TUI is built on top of pi. We thank the authors of pi for their valuable work.

License

Prime Agent is fully open source and released under the MIT License.

Citation

If you use this codebase in your research, please cite Prime Agent:

@article{karten2026prime,
  title={Prime Agent: A Self-Improving RLM Harness},
  author={Karten, Seth and Zhang, Alex L. and Thomas, Kevin and Müller, Sebastian and Bakouch, Elie and Auras, Daniel and Senghaas, Mika and Obeid, Fares and Dunas, Konstantin and Hagemann, Johannes and Jaghouar, Sami},
  journal={arXiv preprint arXiv:2608.23552},
  year={2026}
}

Available at https://arxiv.org/abs/2608.23552.

prime-agent (PrimeIntellect-ai/prime-agent)

Searching Database…

Что это такое?Prime Agent — это open-source агент для программирования и исследований, рассчитанный на общие и долго выполняющиеся задачи. Он построен на двух абстракциях: модели программирования Recursive Language Model (RLM) и Continual Harness, который хранит промпты, память и навыки как долговременное состояние, которое можно постепенно улучшать.
Что именно меняет RLM в том, как всё работает?Контекст превращается в переменные, а инструменты — в вызовы функций внутри постоянного Python REPL: операции с файлами, команды оболочки и субагенты — всё выполняется через код. Вызов rlm(...) порождает настоящих дочерних агентов для параллельной или фоновой работы и возвращает их результаты программно.
Как установить и запустить?На macOS или Linux запустите установщик: он скачает последний стабильный релиз, проверит контрольную сумму SHA-256, установит команду prime-agent и при необходимости подготовит окружение Python. Затем запустите prime-agent из репозитория или каталога, в котором хотите, чтобы он работал.
Нужны ли мне свои API-ключи или подписка?При первом запуске вы авторизуетесь через /login — там можно выбрать либо подписку, либо провайдера с API-ключом, смотря что у вас уже есть.
Безопасно ли указывать ему на мой основной репозиторий?Он выполняет сгенерированный моделью Python и команды проекта с полными правами вашего пользователя — рабочие процессы и ядро добавляют изоляцию жизненного цикла и восстановление, но это не защитная песочница. README советует использовать одноразовый клон или чистый worktree, который можно проверить и восстановить.
Это только для программирования или для другой работы тоже?Это агент для программирования и исследований, но в README особенно подчёркивается долгая работа — в первую очередь оценки (evaluations) в исследованиях — с компакцией, постоянными целями, heartbeat-ами и расписаниями, которые поддерживают задачи между ходами.
Это open source?Да — полностью открытый проект под лицензией MIT License.
Что агент может улучшить в самом себе?Команда /refine анализирует текущую траекторию работы и может вносить небольшие, подтверждённые фактическими данными правки в дополнительное состояние harness — промпты, память, описания навыков и переиспользуемые спецификации субагентов. Неизменяемый базовый системный промпт она никогда не переписывает, а сохранённые снимки позволяют откатить изменения.
Что будет, если мой терминал отключится посреди задачи?Сессии работают через демон: состояние Python REPL, расписания и субагенты продолжают работать после отключения, и к ним можно подключиться позже. /goal удерживает цель активной между ходами, пока она не будет выполнена или приостановлена, а heartbeat-ы и расписания возвращают агента в сессию периодически или в заданное время.
Можно ли оставить его работать самостоятельно?Да — /autonomous продолжает работу в рамках заданных лимитов по ходам, токенам и времени и может запускать пользовательские проверки качества. Но учтите: пройденная проверка гарантирует только то, что она проверяет, а достижение лимита не означает, что задача выполнена успешно.
Могу ли я упаковать в него свои повторяющиеся рабочие процессы?Навыки (skills) — это импортируемые Python-пакеты, а встроенный создатель навыков превращает повторяющиеся рабочие процессы в проектные или личные навыки. Для автоматизации без интерфейса и интеграций есть также режим JSON и режим RPC.
Size
111.4 MB
Stars
22.1K
Age
5mo
Commits · 90 Days