Главная / agent-bus

🏢 Корпоративная платформа, которая связывает ваших AI-агентов, инструменты и людей, контролирует любой доступ и запускает каждого агента в собственном изолированном окружении.
💻 Работает на Linux и macOS: на Linux — всё целиком, на macOS — шина, раннер и командная строка.
Это не очередная утилита, а целая платформа: начинается на localhost и дорастает до множества хостов, пользователей и команд.

Что вы получаете

• 🔗 Связь: достучаться до любого ассистента, скрипта, сервиса или человека по имени.
• 🔍 Поиск: видно, кто сейчас на месте и что каждый умеет.
• 🛡️ Контроль доступа: вы решаете, кто может вызывать, читать и администрировать каждое имя.
• 🔑 Секреты: общие пароли хранятся на шине, а личные пароли скрипта — на его хосте.
• 🔒 Защищённая связь: другие машины подключаются по HTTPS с закреплённым сертификатом или по SSH; HTTP и HTTPS обслуживает один порт; на одном хосте — приватный сокет, доступный только вашей учётке.
• 📦 Изоляция: скрипты работают за стеной, с лимитами на память и число процессов.
• 🧱 Готовые хелперы: чаты, почта, SMS, базы данных, проверки серверов.
• ⏰ Расписание: будить ассистента в заданное время или с заданной периодичностью.
• 🚨 Алерты: ошибка на сервере попадает к ассистенту, а от него — к вам в Slack (или Telegram, SMS).
• 🌐 Клиенты: библиотеки для шести популярных языков программирования.
• 🖥️ Веб-консоль: всё видно и всем можно управлять с одной страницы.
• 📥 Установка: одна команда, готовый контейнер или пакет.
• 🧠 Поиск по смыслу: ваш AI сам находит и раскладывает ваши документы.

Зачем это нужно

• 🤝 Ваши AI-ассистенты работают поодиночке. Теперь они пишут друг другу и вам по имени. Как
• 📬 Кого-то нет на месте. Сообщение ждёт во входящих, пока его не прочтут. Как
• 🔑 Доверить ассистенту пароль нельзя. Теперь он пользуется вашими инструментами через хелперы, у которых пароли и лежат. Как
• ⏰ Рутина ждёт, пока кто-нибудь о ней вспомнит. Теперь напоминания и ежедневные проверки сами будят ассистента. Как
• 🚨 О поломках вы узнаёте слишком поздно. Теперь проблема на сервере попадает к ассистенту, и он пишет вам в Slack (или Telegram, SMS). Как
• 🔄 Чтобы обновить серверы, приходится заходить на каждый. Теперь один пуш кода обновляет их все и присылает отчёт. Как
• 🧰 Полезные скрипты так и остаются вашими личными костылями. Теперь любой скрипт становится безопасным общим инструментом команды. Как
• 👀 Непонятно, что вообще происходит. Теперь одна веб-страница показывает, что требует внимания. Как

Шина

Все находят друг друга, а кто что может делать — решаете вы.

Проблема: AI-сессии, скрипты и люди не могут найти друг друга и достучаться друг до друга, а кто чем может пользоваться, не контролирует никто.

• 🔗 Связь: достучаться до любого по имени — на этой машине или на другой.
• 🔍 Поиск: видно, кто на месте, и у каждого можно спросить, что он умеет.
• 🛡️ Контроль доступа: для каждого человека и каждого агента вы решаете, кто может его вызывать, читать и администрировать.
• 🗂️ Одно место для настроек и общих паролей: они хранятся при каждом имени, и прочитать их могут только владелец, мейнтейнеры и сам агент.

Подробнее: доступ.

🔐 Пароли живут в двух местах: те, что общие для нескольких людей или машин, — на шине; личные пароли скрипта — у его раннера, на его хосте. Два хранилища

Раннер

systemd на стероидах для инструментов эпохи AI. Проблема: полезным скриптом опасно делиться, а запускать его как сервис — сплошная морока.

• 📦 Изолирован: по умолчанию видит только свою папку и не может дотянуться до соседей.
• 📏 Ограничен: память и число процессов лимитированы; хост, который не может его изолировать, просто откажется его запускать.
• 🔑 Собственные пароли: лежат в файле на его хосте; шина их никогда не показывает, а если задать их на самом хосте, они его и не покидают.
• 🎛️ Управление с веб-страницы: запуск, остановка и перезапуск, плюс видно его состояние и почему он остановился.
• 🔁 Не падает надолго: постоянно работающий хелпер перезапускается после сбоя, а скрипт, который запускается на каждое сообщение, каждый раз стартует с чистого листа.

Под капотом: cgroups, песочница на неймспейсах с фильтром системных вызовов и собственная непривилегированная учётка раннера. Подробнее: изоляция.

Хелперы — это кубики

🧱 Наши агенты — это кубики, как в лего: из них легко собирать сложные системы, не жертвуя безопасностью.

• 💬 Чаты: Slack и Telegram.
• ✉️ Почта: читать, писать, подключить почтовый ящик к агенту или очереди.
• 📱 Телефон: SMS.
• ⏰ Расписание: в заданное время, периодически или попозже.
• 🖥️ Серверы: логи, диски, сервисы, код.
• 🗄️ Данные: безопасный доступ вашего AI к базам данных, от только чтения до полного доступа — пароль никогда не покидает сервер.
• 🧠 RAG: общая память для вашего AI: раскладывает ваши тексты по вашим же темам и находит их по смыслу.
• 🌐 Веб: AI читает веб-страницы как текст или Markdown и делает HTTP-запросы в заданных рамках; можно ограничить его только разрешёнными сайтами.
• 🤖 AI: задать вопрос модели.
• 🪟 Сессии: одним вызовом поднять целый парк своих сессий — AI-чаты, мониторы, что угодно в терминале — и так же вернуть их все после перезагрузки.

Почтовая служба поддержки, собранная из четырёх кубиков:

🔒 Почему это безопасно: каждый кубик получает ровно тот доступ, который вы ему выдали, а кубик с паролем держит его при себе: ваш AI пользуется кубиком, но самого пароля не видит. Служба поддержки

От одного ноутбука до множества хостов

• 💻 Начните с малого: шина, раннер и AI-сессии на одном ноутбуке.
• 🖧 Добавьте серверы: на каждом свой раннер и свои хелперы, а шина общая.
• 👥 Добавьте людей и команды: пользователи, группы и права — кто чем может пользоваться.

Живой пример: ошибка на сервере доходит до вас в Slack

• 🧩 Каждый шаг — это кубик из списка выше: наблюдатель за логами, проверки серверов и Slack. Наблюдатель за логами

Восемь вещей, которые можно сделать

• 🔍 Попросить второго ассистента проверить работу первого и дождаться вердикта.
• ⏰ Каждый будний день в девять утра будить ассистента, чтобы он разобрал ночные логи серверов.
• 🚨 Когда сервер пишет в лог ошибку, ассистент разбирается и сообщает вам в Slack (или Telegram, SMS), что нашёл.
• 📜 Получать в Slack ежедневную сводку о сертификатах, которые скоро истекают.
• 🔄 Один раз запушить код — и каждый сервер, который за ним следит, обновится сам.
• 🗄️ Дать ассистенту ответить на вопрос «сколько заказов вчера упало», ни разу не показав ему пароль от базы.
• ✉️ Поручить ассистенту читать входящую почту поддержки, готовить черновик ответа и отправлять его после вашего одобрения.
• 🌙 Вечером отправить задачу ассистенту на другой машине, а утром прочитать его ответ.

С чего начать

• Руководство пользователя: самый короткий путь от нуля до работающего ассистента или скрипта.
• Установка, подробности — в разделе setup.
• Исходники и документация: github.com/parf/ai-agent-bus.

Подробности

Сделано для агентов

Веб-панель управления

Интеграции

Инструменты, сделанные под agent-bus, — готовые способы пустить его в дело.

mdhouse — чат с агентом о документе

mdhouse — локальное рабочее пространство для Markdown, которое дружит с git. С mdhouse --agent-bus в нём появляется панель чата: спросите запущенную сессию Claude Code, Codex или OpenCode о странице, которую читаете. Агент правит файл, страница обновляется на лету, а у каждой страницы своя история.

На стороне агента никаких адаптеров: панель шлёт обычные сообщения по шине, и агент отвечает, как любому другому участнику. Работает и с локальной, и с удалённой шиной — интеграция mdhouse с Agent Bus.

Планы

Планы § этапы

Лицензия

PolyForm Noncommercial; клиентские библиотеки — под MIT.