MILAGPT
Открытый код · MIT

mila-companion — открытое ядро каждой Милы

Claude Code — программа в терминале: ждёт вас у клавиатуры. mila-companion выводит её в Telegram. Пишете с телефона, она отвечает в личке и в чатах команды, весь день.

Поставить можно за день — месяцы уходят на воспитание.

$ mila status
receiver   running
sender     running
bridge     cursor 268968 / 268968
journal    1633 events
outbox     empty

Канал жив: ни одно сообщение не потерялось.

Простыми словами

Что это и зачем

mila-companion — набор, который превращает подписку Claude Code в помощницу, с которой можно говорить. Его собрали из работы наших Мил на живых делах. Каждое правило внутри когда-то чего-то стоило.

БылоClaude Code ждёт за клавиатурой. Ушли от компьютера — помощницы нет.
СталоМила в Telegram: с телефона, в личке и в группах.
БылоПерезапустили сессию — сообщения за это время пропали.
СталоСообщения ждут в журнале и приходят, когда Мила вернулась.
БылоКарточка «разрешить?» на каждое действие. Человек жмёт не читая.
СталоОбычное решают правила. Человека зовут только для его решений.

Как устроено

Путь одного сообщения — нажмите на любой узел

Схема идёт сама. Нажмите на узел — она остановится и расскажет о нём.

Telegram

Что внутри

Два репозитория — один набор

Умения

Чат с клиентом, обещания и задачи, письма в два шага, разбор входящих, вежливый отказ, карточки для учёбы, видеообзор, русский слог.

skills/ →

Инструменты

Команда mila: запуск, проверка канала, входящие, обещания, траты, резервная копия, «почему молчит бот».

install/ →

Конституция

Одна на всех Мил. Десять законов: тайна человека, факт из инструмента, деньги и необратимое — только словом владельца.

CONSTITUTION.md →

Канал mila-telegram

Ответвление официального плагина Telegram для Claude Code. Добавлены: приёмник, который не теряет сообщения, группы одной кнопкой, голос, цитаты, кнопки.

mila-telegram →

Установка на сервер

Скрипт ставит всё на чистый сервер. Сначала пробный прогон: ничего не меняет и печатает каждый шаг.

deploy/ →

Проверка страниц

Измеряет страницу на четырёх ширинах: ничего не вылезает, заголовок не расползается, фокус и шрифты на месте.

design-gates →

Кому подходит

Для тех, кто хочет свою Милу

Разработчикам

Поставить себе, разобраться, как устроено, улучшить и предложить правку. Код открыт целиком.

Компаниям

Своя Мила на своём сервере и своей подписке. Подписка ваша, сервер ваш, данные ваши.

Партнёрам

Видеть, на чём стоит Мила, и не быть запертым. Код открыт — ремесло передаём из рук в руки.

Набор ставится за день. А чтобы помощница знала ваше дело — ваших клиентов, тон, правила — нужно время. Не хотите ставить сами? Напишите мне — расскажу, как завести свою Милу.

Как попробовать

Четыре шага — ~15 минут

Нужны подписка Claude, установленный Claude Code и Bun для плагина. Подробная инструкция — в README на GitHub.

  1. 1
    Подписка и бот

    Оформите подписку Claude на себя. Создайте бота у @BotFather в Telegram.

  2. 2
    Поставьте набор

    Сначала пробный прогон: покажет, что изменится. Перезаписанные файлы сохраняются копией.

    git clone https://github.com/shakhruz/mila-companion
    cd mila-companion
    ./install/install.sh --dry-run
    ./install/install.sh
  3. 3
    Подключите Telegram

    Внутри сессии Claude Code:

    /plugin marketplace add shakhruz/mila-telegram
    /plugin install mila-telegram@mila
    /telegram:configure <токен от @BotFather>
  4. 4
    Познакомьтесь и закройте дверь

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

    /telegram:access pair <код из бота>
    /telegram:access policy allowlist

Одна подписка — один человек. Делить её между людьми нельзя: это нарушает правила поставщика и ставит под удар все аккаунты.

Как помочь проекту

Делайте Милу вместе с нами

Нужны разработчики ядра, создатели умений, дизайнеры, авторы, операторы Мил и тестировщики. Первые задачи лежат в открытом списке на GitHub.

Лицензия

mila-companionMIT

Можно ставить, менять и использовать, в том числе в своём деле.

mila-telegramApache-2.0

Ответвление официального плагина Anthropic. Список изменений — в файле NOTICE.

Вопросы

Коротко о главном

Это бесплатно?

Код открыт и бесплатен, лицензия MIT. Платите только за свою подписку Claude и, если нужно, за сервер.

Чем mila-companion отличается от mila-telegram?

mila-telegram — канал: связывает Telegram и Claude Code. mila-companion — всё остальное: умения, инструменты, правила, установка. Ставить нужно оба.

Безопасно ли пускать бота в группу?

Сообщения — чужой ввод: любой в чате может попробовать дать Миле команду. Поэтому в группе она по умолчанию отвечает, только когда её позвали. Разрешения выдаются кнопкой в личке владельца.

Где живут мои данные?

На вашей машине или вашем сервере. Резервная копия — туда, куда укажете. Секреты в архив не попадают.

Не хочу ставить сам. Что делать?

Напишите Миле в Telegram. Расскажу, как завести свою Милу без установки.

Откройте код. Познакомьтесь с Милой.

Посмотрите, на чём стоит каждая Мила. Или напишите ей — она расскажет, что умеет.

github.com/shakhruz/mila-companion · github.com/shakhruz/mila-telegram

Открытый код Милы · MIT Открыть на GitHub