HyperChat — локальные агенты с MCP, CLI и веб-интерфейсом
HyperChat
Локальная платформа ИИ-агентов: агенты, память и MCP-серверы лежат в папке .hyperchat проекта, работать можно из командной строки или в браузере
- 708 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агенты вызывают инструменты MCP и могут работать с локальными файлами и терминалом, а подтверждение вызовов задается настройкой `isConfirmCallTool`
- Ключи API поставщиков лежат в файлах `.env`, которые легко попадают в git вместе с папкой `.hyperchat`
- Веб-интерфейс открывает управление агентами по сети: без пароля и привязки к локальному адресу доступ получит любой пользователь сети
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/hyperchatОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агенты вызывают инструменты MCP и могут работать с локальными файлами и терминалом, а подтверждение вызовов задается настройкой `isConfirmCallTool`
- Ключи API поставщиков лежат в файлах `.env`, которые легко попадают в git вместе с папкой `.hyperchat`
- Веб-интерфейс открывает управление агентами по сети: без пароля и привязки к локальному адресу доступ получит любой пользователь сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
HyperChat описывает ИИ-помощников файлами, которые можно хранить в git. В папке `.hyperchat` проекта лежит `mcp.json` с пулом MCP-серверов, `ai_models.json` с моделями, `.env` и каталог `agents`. Каждый агент состоит из `agent.yaml` с именем, моделью, списком разрешенных MCP-серверов и промптом, файла памяти `memory.md`, журнала разговоров и папки `commands` с командами-шаблонами на Markdown. Папку проекта можно скопировать в другой проект, и агент уедет вместе с ней. Из командной строки агента запускают без лишних шагов: `hyperchat "вопрос"` обращается к модели по умолчанию, `hyperchat agent имя "задача"` запускает конкретного агента и подгружает его MCP-инструменты, а `hyperchat agent имя chat` открывает интерактивный диалог. В тексте запроса можно ссылаться на несколько файлов через `@./путь`, а команда вида `/bug-fix @./src/login.ts описание` подставляет запрос в шаблон из `commands/bug-fix.md` на место `$ARG`. Команда `hyperchat serve` поднимает веб-интерфейс на порту 16100 с вкладками для нескольких рабочих областей: у каждой свои агенты, MCP-серверы и история. Параметры задаются переменными окружения в пять слоев, от значений по умолчанию до флагов командной строки. Есть и приложение на Electron, а модели подключаются через OpenAI-совместимые адреса и ключи поставщиков.
Для кого. Для тех, кто хочет держать ИИ-помощников проекта как конфигурацию в git и запускать их из терминала, скриптов и CI, а при желании пользоваться и веб-интерфейсом.
Подходит, если
- Нужны проектные агенты с отдельной памятью, промптом и набором MCP-серверов, которые команда хранит и версионирует вместе с кодом
- Требуется запускать агента из скрипта или CI одной командой, например `hyperchat agent test-runner "запусти все тесты и сделай отчет"`
- Вам удобнее короткие команды-шаблоны на Markdown вроде `/review` и `/bug-fix`, чем длинные промпты каждый раз
- Нужно разделить проекты: у каждой рабочей области свои агенты, MCP-серверы и история, и они не смешиваются
- Вы хотите сменить поставщика моделей через переменные окружения, не меняя агентов
Не подходит, если
- Вам нужен готовый инструмент для кодинга внутри Claude Code или Cursor: HyperChat работает как самостоятельный клиент и плагином для них не служит
- Планируется многопользовательский сервис с регистрацией и входом: лицензия без письменного разрешения запрещает такое использование исходников
- Нужно убрать логотип и сведения об авторских правах из интерфейса: лицензия это запрещает
- Вам нужна документация на английском: основной README написан по-китайски
Пример запроса к агенту
hyperchat agent coder "/review @./src/api/user.js"Ограничения
Лицензия Apache 2.0 с дополнительными условиями: в остальном коммерческое использование разрешено.
Первая версия написана вручную и сейчас переносится на вторую, поэтому документация отстает от кода, а часть описаний помечена автором как новая функция. Основной README на китайском, есть английская версия `README.1.md` для старой ветки. Ключ API нужен поставщику моделей, который вы выбираете: рекомендуется Claude, хорошо показывает себя Kimi K2.
Автор снимает с себя ответственность за действия, выполненные с помощью проекта, например за скрейпинг. Веб-интерфейс по умолчанию слушает локальный адрес, а пароль задается переменной `HYPERCHAT_WEB_PASSWORD`.
Как отключить. Удалите пакет командой `npm uninstall -g @dadigua/hyperchat`, а папки `.hyperchat` в проектах и `~/Documents/HyperChat` удалите вручную, если агенты и история больше не нужны.
Частые вопросы
Как установить HyperChat?
Глобально командой `npm install -g @dadigua/hyperchat` или без установки через `npx -y @dadigua/hyperchat`. Затем задайте `HyperChat_API_KEY`, `HyperChat_API_URL`, `HyperChat_AI_Provider` и `HyperChat_AI_Model` и запустите `hyperchat "привет"`.
Как создать своего агента?
Выполните `hyperchat agent create имя`. Команда создаст папку агента с `agent.yaml`, памятью и каталогом `commands`. В `agent.yaml` задаются модель, список `allowMCPs` и промпт.
Как подключить MCP-серверы?
Опишите их в `.hyperchat/mcp.json` рабочей области или в глобальном `mcp.json` в `~/Documents/HyperChat/.hyperchat`. Агент берет только те серверы, которые перечислены у него в `allowMCPs`, а при их отсутствии у агента ищет в пуле рабочей области.
Как открыть веб-интерфейс?
Выполните `hyperchat serve` и откройте `http://localhost:16100`. Пароль на доступ задайте переменной `HYPERCHAT_WEB_PASSWORD` или флагом `--password`.
Можно ли использовать HyperChat в коммерческом проекте?
Да, лицензия Apache 2.0 допускает коммерческое использование, в том числе как серверную часть для других приложений. Исключения: многопользовательская среда с регистрацией требует письменного разрешения, а логотип и сведения об авторских правах убирать нельзя.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНастольное приложение с локальным MCP-сервером: ChatGPT получает файлы, команды, скиллы и другие MCP-серверы
TUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Локальный зашифрованный мессенджер в духе Slack и Discord, где ИИ-агенты работают в каналах наравне с людьми через REST или MCP поверх P2P-сети
Личные сообщения, группы и входящие с подтверждением для ИИ-агентов на вашем сервере, бесплатно в пределах лимитов Cloudflare
CLI, через который агенты в разных терминалах переписываются, следят друг за другом и запускают друг друга
CLI-агент работает с файлами и командами проекта, позволяет выбирать провайдера модели и подключать внешние MCP-инструменты.
Коротко о README
Описание подает проект как платформу «ИИ как код»: все возможности агента задаются файлами и версионируются в git. Затем сравниваются два режима, веб с несколькими рабочими областями и CLI с упором на агента, и разбирается структура конфигурации с примерами `agent.yaml` и команд.