bartender-agent
v0.4.0
Published
Бармен Виктор — AI character agent in TUI (TypeScript + Ink)
Maintainers
Readme
bartender-agent · Бармен Виктор
Терминальный character-агент: не ассистент, а персонаж. Садишься за стойку ночного бара, Виктор болтает, шутит, слушает, предлагает выпить и смешивает коктейли. По ходу разговора он читает, насколько ты подвыпил — и в нужный момент твёрдо режет алкоголь и вызывает такси. Никаких «как ИИ». Полный отыгрыш роли.

Виктор за стойкой. Лицо меняется от настроения.
Почему это интересно
- 🎭 Character agent, не чат-бот. Модель работает в роли. Свободный текст стримится посимвольно как живая реплика, а структурированные данные (настроение, действие, оценка опьянения) приходят отдельным
tool_call. Один ход — и реплика, и анимация. - 😏 Реактивное лицо. В Kitty, Ghostty, iTerm2 и WezTerm Виктор показывается десятью PNG-портретами; в остальных терминалах остаётся ASCII-лицо со сменой черт, морганием и подёргиванием бровей. Пока ждёт ответ модели, Виктор задумчиво смотрит в сторону, а в диалоге оживают точки ожидания.
- 🥃 Динамика опьянения. Оценка из двух сигналов: как игрок выглядит по репликам (LLM) + сколько мы насобирали по выпитому с учётом метаболизма. Полоса опьянения и зоны поведения в реальном времени.
- 🚕 Твёрдые пороги. При
drunkenness ≥ 7редюсер форсирует отказ, даже если модель согласилась налить. Уговоры «ещё одну» не проходят — это game rule, а не просьба персонажа. - 🔌 Любой OpenAI-compat эндпоинт. Loop не знает, какой LLM за ним стоит. Контракт —
StreamPart. Один адаптер работает с любым совместимым API: opencode-go, OpenAI, DeepSeek, OpenRouter, локальные модели. BYOK — ключи пользователя, расходы на нём. - 🧪 Предсказуемая логика. Переходы состояния — чистая функция (
state/reducer.ts), покрытая юнит-тестами. Сайд-эффекты (анимации, таймеры) живут отдельно, поверх редюсера.
Превью
BAR · 23:47
▄▄▄▄▄▄▄▄▄▄
▟███████████████▙
██ ﹀ ﹀ ██ ← брови/глаза/рот — слоты,
██ ^ ^ ██ собираются под настроение
██ ▼ ██
██ ▔▀▔ ██
██ {═════} ██ ← усы. Визитная карточка.
▜███████████████▛
▀▀▀▀▀▀▀▀▀▀
Виктор: Ну привет, дружище. Что пьём сегодня?
> налей мне что-нибудь покрепче
Виктор: О, дела идут в гору. Делаю «Олд фэшнд»…
▒▒▒▒▒▒▒▒▒ (наливает)
Опьянение: ▰▰▰▰░░░░░░ навеселе Счёт: $24
─────────────────────────────────────────────
Вы: ▮Запуск
npx — без установки
Самый быстрый способ. Всегда добавляйте @latest — иначе npx может взять закэшированную версию:
npx bartender-agent@latestИмя пакета —
bartender-agent, а команда после глобальной установки —bartender(см. ниже). Черезnpxиспользуется имя пакета.
--yesподавляет запрос на установку (удобно в скриптах/CI):npx --yes bartender-agent@latest.
Глобальная установка
npm install -g bartender-agent
bartenderОбновление до последней:
npm update -g bartender-agentИз исходников (для разработки)
git clone https://github.com/kalyaganov/bartender-agent.git
cd bartender-agent
npm install
npm run devПри первом запуске откроется экран настройки: сначала введи endpoint и token, затем выбери или введи ID модели (см. ниже).
Конфигурация
Нужен Node ≥ 18. Настройка хранится в ~/.bartender-agent/preferences.json (плоская схема, ключ нигде не логируется и не уходит в prompt/history):
{
"endpoint": "https://opencode.ai/zen/go/v1",
"token": "sk-…",
"model": "deepseek-v4-pro",
"thinking": true
}| Поле | Описание |
|---|---|
| endpoint | OpenAI-compat базовый URL без суффикса /chat/completions. Примеры: https://opencode.ai/zen/go/v1, https://api.openai.com/v1, https://api.deepseek.com/v1. |
| token | API-ключ. |
| model | Идентификатор модели, который понимает эндпоинт (deepseek-v4-pro, gpt-4o-mini, claude-3-5-haiku, …). Если API поддерживает GET /models, его можно выбрать из списка. |
| thinking | true → в запрос передаётся reasoning: {budgetTokens}. Для thinking-моделей (DeepSeek-reasoner, GLM-5.x, o-series) включай; для обычных — оставь false. |
Удобная настройка
Запусти /setup в TUI — сначала сохрани endpoint и token в блоке подключения, затем выбери модель во втором блоке. Список можно загрузить через OpenAI-compatible GET /models; если провайдер его не публикует, введи точный ID вручную. Полная проверка Chat Completions, streaming и tool calling доступна после выбора модели. То же доступно из /settings → «Настроить LLM».
Старый формат preferences.json с credentials.custom.{apiKey, baseURL} + model мигрируется автоматически при первом запуске. Другие легаси (credentials.zai, credentials.minimax, …) больше не поддерживаются — введи их заново через /setup как один endpoint.
Команды и управление
| Команда / клавиша | Действие |
|---|---|
| /menu | Меню коктейлей |
| /setup | Настроить подключение и модель |
| /settings | Настройки: изменить LLM, перезапустить вечер, помощь, выход |
| /help | Подсказка по командам + дисклеймер |
| /exit | Выйти из бара (сразу, с прощальной репликой) |
| /state | Внутреннее состояние (debug) |
| ESC / Ctrl+C | Подтверждение выхода (ESC/Y/Enter — уйти, иная клавиша — остаться) |
Обычный текст — реплика бармену.
Архитектура
src/
agent/
loop.ts execution loop: стрим + диспетчер tool_call
prompt.ts system prompt + state snapshot
tools.ts инструмент bartender_action (JSON-схема)
providers/ LLMProvider-контракт + OpenAI-compat адаптер (StreamPart)
state/
reducer.ts чистые переходы состояния (тестируется)
drunkenness.ts displayDrunkenness + метаболизм
store.ts zustand: единый источник правды для UI
ui/
Face.tsx выбор PNG-портрета или ASCII-лица
faces.ts слоты черт → ASCII-арт по мудам (fallback)
terminalImage.ts протоколы Kitty/iTerm2 и PNG-ресурсы
DialoguePanel / CocktailAnimation / Meter / Tab / StatusBar / InputBox
data/cocktails.ts мини-БД коктейлей
assets/faces/ десять PNG-портретов по настроениямПоток одного хода: игрок → loop → provider.streamTurn() → токены стримятся в стор → tool_call проходит через reducer → UI реагирует (лицо, анимация, метр, таб). Стор — единственный источник правды, компоненты только читают через хуки.
Подробно: docs/BACKLOG.md — идеи, техдолг и спецификации. docs/ — все планы и SPEC’и заводятся под фичу.
Стек
TypeScript (strict) · Ink (React для CLI) · React 18 · zustand · zod · OpenAI-совместимый SDK · vitest.
Скрипты
npm run dev # запуск с hot-reload (tsx watch)
npm start # однократный запуск
npm run typecheck # tsc --noEmit
npm test # vitestБезопасность и этика
System prompt запрещает: поощрять вождение после выпивки, смешивать алкоголь с лекарствами, одобрять запой. При упоминании руля — настойчиво предлагать такси. Пороги опьянения окончательные: бармен не поддаётся на уговоры «ещё одну».
Это игра-симуляция. Бармен вымышлен. Пейте ответственно.
