Linchpin

Что такое Linchpin?

Linchpin — самохостируемый runtime для AI-агентов, поддерживающий работу с множеством провайдеров моделей и локальными моделями. Он предназначен для маршрутизации запросов к разным LLM, запуска каждой сессии агента в изолированной среде и предоставления контролируемого набора встроенных и внешних инструментов.

Его основная цель — снижение зависимости от моделей/провайдеров при предоставлении агентам песочницы для выполнения и управляемого доступа к инструментам, учётным данным и потокам событий.

Ключевые возможности

• Любая модель, один адаптер: Linchpin маршрутизирует к ~200 облачным моделям (включая Claude, GPT, Gemini, Llama, DeepSeek, Mistral и Qwen) через OpenRouter и использует Ollama для локальных моделей; переключение провайдеров на агента.
• Песочница сессий с Docker-контейнерами на сессию: Каждая сессия запускается в своём Docker-контейнере с предустановленными Python, Node, git и ripgrep для一致ной среды инструментов.
• Настраиваемая сеть по окружениям: Сеть может быть none для строгих ограничений или open egress для менее жёстких настроек.
• Восемь встроенных инструментов контейнера: Агенты используют инструменты вроде bash, read, write, edit, glob, grep, web_fetch и web_search с выполнением внутри контейнера.
• Интеграция MCP и HTTP-инструментов: Linchpin подключает серверы Model Context Protocol (MCP) через stdio или любые HTTP-эндпоинты; коннектор управляет жизненным циклом процессов и инъекцией учётных данных.
• Шифрованные хранилища учётных данных: Учётные данные хранятся с шифрованием Fernet; агенты ссылаются на секреты по имени в конфигах, секреты дешифруются при старте сессии без записи в plaintext на диск.
• Поток событий только-приложении на сессию: Linchpin ведёт append-only лог событий на сессию с поддержкой курсорной пагинации; клиенты подписываются по SSE для воспроизведения событий после курсора и стриминга обновлений в реальном времени.

Как использовать Linchpin

1. Выберите путь модели: Настройте агента на облачную модель через OpenRouter (для выбора провайдера) и/или локальную через Ollama.
2. Запускайте сессии агентов в песочнице: Запускайте сессии, зная, что каждая использует свой Docker-контейнер с предустановленными инструментами; настройте сеть под нужды окружения (none vs open egress).
3. Выберите инструменты для агента: Используйте встроенные инструменты Linchpin (bash, операции с файлами, поиск/загрузка) и опционально добавьте MCP-серверы (через stdio) или подключите HTTP-эндпоинты как внешние инструменты.
4. Предоставьте учётные данные безопасно: Храните учётные данные в зашифрованном хранилище Fernet Linchpin и ссылайтесь на секреты по имени в конфигах агентов.
5. Стриньте события в UI или сервис: Подписывайтесь по SSE и используйте курсорную пагинацию для воспроизведения прошлых событий и получения обновлений.

Сценарии использования

• Развёртывание агентов с несколькими провайдерами: Запуск одного workflow агента на разных LLM (например, Claude для одной задачи и GPT для другой) с一致ным набором инструментов и песочницей.
• Запуск агентов на локальных моделях: У вас есть локально загруженные модели, и вы предпочитаете Ollama с теми же контейнеризированными инструментами и изоляцией сессий независимо от места запуска модели.
• Песочница для кода и файловых workflow: Агент, редактирующий/ищущий файлы проекта или выполняющий shell-команды, работает внутри своего Docker-контейнера с ограниченной сетью при необходимости.
• Инструменты через MCP-серверы: У вас есть MCP-серверы, предоставляющие возможности агентам; Linchpin подключается к ним по stdio и управляет жизненным циклом коннектора и инъекцией учётных данных.
• Живые фиды событий для UI: Вы строите интерфейс с историей и live-обновлениями; воспроизводите записи лога событий от курсора и продолжайте стриминг в реальном времени по SSE.

Часто задаваемые вопросы

• Требует ли Linchpin конкретного провайдера моделей? Нет. Linchpin маршрутизирует через OpenRouter к множеству облачных моделей и может запускать локальные модели через Ollama, с выбором провайдера, настраиваемым для каждого агента.

• Как изолируются сессии агентов? Каждая сессия запускается в отдельном Docker-контейнере с предустановленными инструментами, такими как Python и Node. Сеть может быть ограничена (отсутствует) или разрешена (открытый исходящий трафик) в зависимости от окружения.

• Какие инструменты доступны агентам? Linchpin включает восемь встроенных инструментов (bash, read, write, edit, glob, grep, web_fetch, web_search) и может интегрировать внешние инструменты через MCP-серверы (stdio) или HTTP-эндпоинты.

• Как Linchpin обрабатывает учётные данные? Учётные данные хранятся в зашифрованном хранилище Fernet и ссылаются по имени в конфигурациях агентов. Они расшифровываются при запуске сессии и не записываются на диск в открытом виде.

• Можно ли стримить активность агента на фронтенд? Да. Linchpin ведёт лог событий только для добавления на сессию и поддерживает подписки SSE, которые воспроизводят события после курсора, а затем стримят новые события в реальном времени.

Альтернативы

• Самохостируемые runtime для агентов с песочницей: Альтернативные платформы, запускающие агентов в изолированных контейнерах, также обеспечивают контролируемое выполнение инструментов; разница часто в интеграции моделей и инструментов (маршрутизация провайдеров, поддержка MCP/HTTP и модель стриминга событий).
• Фреймворки только для локальных моделей: Фреймворки, ориентированные на локальные модели (например, построенные вокруг локального инференса), избегают маршрутизации внешних провайдеров, но могут предлагать разные уровни переключения провайдеров и управления инструментами/учётными данными.
• Коннекторы инструментов с фокусом на MCP: Если основная потребность — подключение MCP, могут подойти альтернативы, акцентирующие интеграцию MCP-инструментов; по сравнению с Linchpin нужно оценить обработку изоляции сессий, хранения учётных данных и стриминга.
• Собственные реализации SSE/логов событий: Некоторые команды строят собственный лог событий и стриминг SSE вокруг системы агентов; компромисс — больше усилий на инженерию для воспроизведения воспроизведения по курсору, логов сессий только для добавления и согласованного поведения инструментов агентов.