RepoRadar Agent Safehouse: изоляция AI-агентов для безопасного доступа к файлам
Agent Safehouse — это инструмент для изоляции локальных AI-агентов, чтобы они могли читать и записывать только те файлы, которые им нужны. Он полезен для разработчиков, работающих с LLM (языковыми моделями), обеспечивая безопасность их проектов, минимизируя риски доступа к лишним данным.
Главное отличие от альтернатив заключается в применении deny-first модели и использовании sandbox-exec с настраиваемыми профилями безопасности. Это позволяет создать гибкую среду, учитывающую специфические требования различных AI-агентов и рабочих процессов. Политики безопасности разрабатываются таким образом, чтобы не усложнять рабочие процессы разработчиков.
Agent Safehouse написан для macOS и его можно установить через Homebrew или скачать скрипт для ручной установки. Имей в виду, что проект на текущий момент ориентирован только на macOS. Кроме того, это не абсолютная защита, а лишь уровень жесткости, который упрощает управление рисками.
Проект Agent Safehouse предназначен для создания безопасной песочницы (sandbox) для агентов программирования на базе LLM (Large Language Model) в операционной системе macOS. Он ограничивает доступ агентов к файлам и интеграциям, которые действительно необходимы для выполнения их задач. В основе работы проекта лежит модель "deny-first", что означает, что изначально доступ ко всем ресурсам запрещен, и только затем можно явно разрешать доступ к необходимым.
Установка
Существует два способа установки Agent Safehouse:
- Через Homebrew:
brew install eugene1g/safehouse/agent-safehouse - Используя автономный скрипт:
mkdir -p ~/.local/bin curl -fsSL https://github.com/eugene1g/agent-safehouse/releases/latest/download/safehouse \ -o ~/.local/bin/safehouse chmod +x ~/.local/bin/safehouse
Принципы работы
Agent Safehouse основывается на принципе минимальных привилегий, что подразумевает:
- Старт с запрета на все операции.
- Разрешение только тех действий, которые необходимы для работы агента.
- Поддержка продуктивности разработчиков.
- Упрощение снижения рисков по умолчанию.
При этом важно отметить, что проект не является абсолютной защитой от целенаправленных атак.
Доступ к HOME
По умолчанию проект предоставляет доступ к домашней директории с некоторыми ограничениями:
- Только метаданные доступны для корневого каталога и директории пользователя.
- Чтение из директорий `~/.config` и `~/.cache` разрешено для обнаружения стандартных мест хранения конфигурации.
- Некоторые определенные файлы/каталоги доступны по умолчанию, такие как метаданные git и ssh.
Если требуется убрать даже эти исключения, можно воспользоваться опцией `--append-profile`, которая позволяет загружать пользовательские правила после базовых и тем самым уточнять доступ.
Документация
Подробная документация доступна на официальном сайте:
Ограничения
Agent Safehouse специально разработан для macOS и использует `sandbox-exec`. Если ты работаешь с Linux, существуют альтернативы для песочницы, такие как vetto, bubblewrap, и firejail. Эти инструменты могут обеспечить аналогичную функциональность на других платформах.
Открыть на GitHub: eugene1g/agent-safehouse →
