PrivAiTe CLI
Локальный прокси заменяет секреты и личные данные в запросах агентов до отправки провайдеру и возвращает их в ответе
- 65 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Прокси видит весь исходящий трафик агента, включая системные промпты, а часть значений детектор может пропустить
- Маршруты шлюза по умолчанию открыты и слушают все интерфейсы, поэтому порт нужно закрыть или привязать к localhost
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/privaiteОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Прокси видит весь исходящий трафик агента, включая системные промпты, а часть значений детектор может пропустить
- Маршруты шлюза по умолчанию открыты и слушают все интерфейсы, поэтому порт нужно закрыть или привязать к localhost
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
PrivAiTe — прокси на Python, который стоит между вашим кодирующим агентом и провайдером модели и очищает каждый запрос. Агент читает `.env`, логи и вывод команд, и все это уходит поставщику модели. PrivAiTe находит секреты и личные данные, заменяет их метками вроде `[SECRET]` до выхода с машины и подставляет настоящие личные данные обратно в ответ, в том числе при потоковой выдаче. Секреты назад не возвращаются: поставляемые настройки удаляют их и маскируют номера карт насовсем. Проверка локальная и без телеметрии: имена и почту ловит Presidio вместе с открытой моделью приватности OpenAI, а с версии 0.8.0 есть и собственная модель `crp4222/privaite-pii-minilm` с двумя режимами `ultrafast` (на Apple Neural Engine, медиана 17 мс) и `minilm` (на процессоре). Режим шлюза понимает собственные протоколы CLI агентов, чистит результаты инструментов и аргументы вызовов и передает вход самого CLI провайдеру без изменений. Быстро проверить можно командой `docker run --rm ghcr.io/crp4222/privaite:0.8.2 python -m privaite verify`: она запускает временного провайдера на 127.0.0.1 и показывает, какие внедренные значения утекли напрямую и какие очищены прокси. Для Claude Code достаточно `ANTHROPIC_BASE_URL=http://localhost:8400 claude`, а в настройках включить `gateway.enabled`.
Для кого. Разработчикам и командам, чьи агенты читают `.env`, логи и данные клиентов, а запросы уходят облачному провайдеру модели.
Подходит, если
- Агент открывает `.env` с ключами, и они не должны попасть в запрос к провайдеру
- В логах и выводе тестов встречаются имена и почта клиентов, их надо заменить на метки
- Нужен единый шлюз для Open WebUI, LiteLLM или любого клиента OpenAI на `localhost:8400`
- Требуется быстро убедиться без ключей API, что подмена работает, командой `verify` в Docker
Не подходит, если
- Нужна гарантия отсутствия утечек: распознавание статистическое и часть значений проходит
- Нужно защитить сам агент: CLI хранит настоящие значения в своем контексте и транскриптах
- Нужна защита системных промптов, например `CLAUDE.md`: поле system проходит без проверки
Пример запроса к агенту
Перед отправкой запроса через PrivAiTe покажи, какие значения из .env и лога будут заменены меткамиОграничения
- Распознавание статистическое: значение, которое детектор не узнал, уходит провайдеру. Незнакомые форматы секретов, закодированные или разделенные значения и голые значения без имени поля могут пройти.
- Защита закрывает исходящий запрос и оставляет сам агент без прикрытия: CLI хранит настоящие значения в контексте и транскриптах, а его системный промпт и `CLAUDE.md` передаются без проверки.
- Маршруты шлюза принимают запрос без значения `PRIVAITE_API_KEYS`, а сервер по умолчанию слушает `0.0.0.0` без ограничения частоты: привяжите его к localhost или закройте порт.
- Это псевдонимизация без полной анонимизации: соответствие значений и меток живет в памяти на время запроса, а окружающий текст может остаться опознаваемым.
Как отключить. Прокси останавливают как обычный процесс или контейнер, а у агента убирают `ANTHROPIC_BASE_URL`. Пакет удаляет `python -m pip uninstall privaite`.
Частые вопросы
Как проверить PrivAiTe без ключей API?
Выполните `docker run --rm ghcr.io/crp4222/privaite:0.8.2 python -m privaite verify`. Команда поднимает временного провайдера и печатает, какие внедренные значения утекли напрямую и какие очищены.
Как запустить прокси для клиента OpenAI?
Выполните `docker run -d -p 8400:8400 -e PRIVAITE_API_KEYS=change-me -e OPENAI_API_KEY=sk-... ghcr.io/crp4222/privaite:0.8.2` и укажите клиенту `http://localhost:8400/v1`. Вместо `change-me` задайте свой ключ.
Как подключить Claude Code?
Включите `gateway.enabled` и укажите `base_url` Anthropic в конфиге, затем запустите `ANTHROPIC_BASE_URL=http://localhost:8400 claude`. Заодно включите `pii.detection_cache.enabled: true`, чтобы не проверять разговор заново каждый ход.
Возвращаются ли секреты в ответ?
Нет. Поставляемые настройки удаляют секреты и маскируют номера карт навсегда, а личные данные подставляются обратно. Поведение по типам меняется настройкой `entity overrides`.
Какой режим выбрать?
По умолчанию работает `onnx`. `light` быстрее и не требует загрузки модели, но пропускает имена. `minilm` и `ultrafast` включаются отдельно и запускают собственную модель проекта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный приватный прокси для кодинг-агентов: подменяет имена, почты и секреты псевдонимами до отправки в модель
Vigils стоит между ИИ-агентом и его инструментами: скрывает секреты, спрашивает разрешения и пишет неизменяемый журнал вызовов
AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
Probe находит сетевые обращения инструмента агента при запуске без сети и готовит черновик политики с минимальными правами
Локальное обезличивание личных данных в документах на традиционном китайском: коды-заменители и точный возврат после ИИ
agent-secrets выдает ИИ-агенту ключи на время: шифрование age, аренда секрета с TTL, журнал доступа и аварийный отзыв.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| PrivAiTe (эта карточка) | нет | 65 | |
| DataFog | нет | 80 | DataFog маскирует данные хуком и ограждением LiteLLM, а PrivAiTe работает как отдельный прокси и шлюз протоколов агентов с возвратом данных в ответ. |
| gate | нет | 214 | Gate чистит данные из баз и результатов MCP до модели, а PrivAiTe чистит сам исходящий запрос агента провайдеру. |
Коротко о README
README объясняет, что секреты и личные данные из `.env` и логов уходят провайдеру, показывает пример подмены, быстрый запуск `verify`, установку, работу с Claude Code и Codex, тесты, интеграции, модель угроз и документацию.