PaiCLI Python CLI
PaiCLI Python — терминальный ИИ-агент: ReAct и планирование, MCP-клиент, память, снимки перед правками и Runtime API.
- 113 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает и пишет файлы, запускает команды оболочки и ходит в сеть, защита держится на подтверждениях и политике путей.
- Ключ провайдера передается во внешний API модели.
Установка
Ручная установка
git clone https://github.com/itwanger/PaiCLI-Python.gitПервая команда быстрого старта. Дальше `cd PaiCLI-Python` и `uv sync --extra dev`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает и пишет файлы, запускает команды оболочки и ходит в сеть, защита держится на подтверждениях и политике путей.
- Ключ провайдера передается во внешний API модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Агент для терминала на Python, который читает и пишет файлы, ищет по коду, запускает команды, ищет в сети и вызывает инструменты MCP. Режимы: цикл ReAct, планирование с графом задач (`--mode plan`) и команда из планировщика, исполнителей и ревьюера (`--mode team`). Опасные действия идут через подтверждение человека, есть политика путей и команд и журнал аудита. Память складывается из файла проекта и долгой памяти в SQLite с дедупликацией и сроком жизни. Перед запуском агента создается снимок, к которому можно вернуться. Runtime API хранит ветки диалога, события и фоновые задачи. PaiCLI сам умеет работать MCP-сервером, а система скиллов подгружает навыки по совпадению с запросом. По умолчанию настроен DeepSeek.
Для кого. Разработчикам, которые изучают устройство агентов или хотят терминального агента с подтверждениями и снимками. Документация на китайском.
Подходит, если
- Нужен разбор архитектуры агента: ReAct, планирование, память, MCP.
- Агент должен спрашивать подтверждение перед командами и записью файлов.
- Перед запуском агента нужен снимок, чтобы откатить правки.
- Агента вызывают из скриптов одним запросом с флагом `-p` и выводом в JSON.
Не подходит, если
- Требуется скилл или плагин для уже используемого агента: PaiCLI сам отдельный агент.
- Документация на китайском вам не подходит.
- Зрелый продукт с поддержкой важнее учебного проекта.
Пример запроса к агенту
Запусти `uv run paicli --mode plan -p "прочитай README и проверь проект" --json` и покажи план и расход токенов.Ограничения
Проект связан с учебным курсом автора по Agent-инженерии: он создан для обучения и портфолио, а не как массовый продукт. Требуются Python 3.11 и `uv`, по умолчанию настроен DeepSeek с ключом `DEEPSEEK_API_KEY`. Установка из клона репозитория, пакет в реестре не заявлен. Для Chrome DevTools MCP нужны Node.js 20.19 и Chrome. Конфиг читается из пяти источников по приоритету, настройки проекта перекрывают пользовательские.
Как отключить. Удалите клон репозитория и каталог `~/.paicli` с настройками и памятью. Снимки и журнал аудита лежат в каталогах проектов, удалите их вручную.
Частые вопросы
Как запустить PaiCLI?
Склонируйте репозиторий, выполните `uv sync --extra dev`, затем `uv run paicli` для интерактивного режима или `uv run paicli -p "запрос"` для одного запроса.
Какой провайдер модели используется?
OpenAI-совместимый клиент со стримингом, по умолчанию настроен DeepSeek с ключом `DEEPSEEK_API_KEY`.
Как проверить окружение?
Команда `uv run paicli doctor --cwd .` проверяет настройку.
Есть ли подтверждение опасных действий?
Да, человеческое подтверждение, политика команд и путей и журнал аудита в формате JSONL.
Что такое режим team?
Планировщик, исполнители и ревьюер работают с зависимостями, параллельными исполнителями и повторами после ревью. Запуск: `uv run paicli --mode team --worker-mode plan -p "запрос"`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI-агент работает с файлами и командами проекта, позволяет выбирать провайдера модели и подключать внешние MCP-инструменты.
Учебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
Локальный кодинг-агент на Python: каждый шаг пишется в журнал, который можно разобрать, воспроизвести и продолжить.
Минималистичный агент для кода в терминале, который расширяется скиллами, шаблонами промптов и пакетами на TypeScript
Кодовый агент для терминала на Go: один бинарник без Node и Python, ревью диффа прямо в интерфейсе и подагенты
Персональный AI-агент в терминале с шеллом, Python, вебом и локальными моделями, один из первых агентных CLI
Коротко о README
README на китайском: описание, учебная дорожная карта, список возможностей, требования, быстрый старт, приоритет конфигурации и работа с провайдерами. Подробный перечень режимов и Runtime API идет в самом списке функций.