Установка Digit
Digit ставится из командной строки. Отдельного дистрибутива Desktop скачивать
не надо: приложение собирается из той же установки — либо сразу флагом
--include-desktop, либо потом, при первом digit desktop.
Все каналы ведут в свой репозиторий digitable-lol/digit, а не в
установочный канал апстрима. Это важно практически: digit update тянет
обновления оттуда же, и установка, поставленная чужим скриптом, обновлялась бы
чужим кодом.
Одна команда
macOS через Homebrew:
brew install digitable-lol/tap/digit
Linux, macOS, WSL2 и Android (Termux):
curl -fsSL https://raw.githubusercontent.com/digitable-lol/digit/main/scripts/install.sh | bash
Windows, PowerShell:
iex (irm https://raw.githubusercontent.com/digitable-lol/digit/main/scripts/install.ps1)
После установки перезагрузите окружение оболочки и запустите мастер:
source ~/.bashrc # или ~/.zshrc
digit setup
digit
Что происходит дальше — на странице «Первый запуск».
Что установщик делает
Клонирует репозиторий, создаёт отдельное виртуальное окружение, доставляет
недостающие зависимости и заводит команду digit в пользовательском PATH.
Повторный запуск обновляет существующую установку, не переписывая
пользовательские настройки.
Из зависимостей он ставит сам: uv, Python 3.11, Node.js 22 (браузерная
автоматизация и мост WhatsApp), ripgrep, ffmpeg.
Что нужно иметь заранее: git. На Linux — ещё curl и xz-utils
(Node.js скачивается архивом .tar.xz). Для сборки Desktop дополнительно
нужен g++ — на Debian и Ubuntu это build-essential.
Куда всё кладётся
Раскладка зависит от того, ставите вы от обычного пользователя или от root.
| Установка | Код | Команда digit |
Данные |
|---|---|---|---|
| Пользовательская | ~/.digit/digit/ |
~/.local/bin/digit (симлинк) |
~/.digit/ |
Системная (от root) |
/usr/local/lib/digit/ |
/usr/local/bin/digit |
/root/.digit/ или $DIGIT_HOME |
Системная раскладка нужна там, где одна установка обслуживает несколько
пользователей: сам код общий, а настройки, навыки и сессии у каждого свои — в
его ~/.digit или в явно заданном DIGIT_HOME.
Каталог данных выглядит так:
~/.digit/
├── config.yaml настройки
├── .env ключи и секреты
├── SOUL.md постоянные указания агенту
├── memories/ память
├── sessions/ переписки
├── skills/ навыки
└── digit/ сам код (при пользовательской установке)
Digit не импортирует сюда данные другого агента автоматически, даже если находит их рядом: там могут лежать чужие ключи и чужая память. При первом запуске он покажет команду переноса, но не выполнит её сам.
Флаги установщика
Передаются после bash -s --:
curl -fsSL …/install.sh | bash -s -- --skip-browser --skip-setup
| Флаг | Что делает |
|---|---|
--skip-setup |
не запускать мастер настройки |
--skip-browser |
не ставить Playwright и Chromium (браузерные инструменты работать не будут) |
--no-venv |
не создавать виртуальное окружение |
--no-skills |
не подкладывать встроенные навыки — ни сейчас, ни при будущих обновлениях |
--branch ИМЯ |
поставить не main, а другую ветку |
--commit SHA |
закрепиться на конкретном коммите |
--dir ПУТЬ |
каталог установки |
--digit-home ПУТЬ |
каталог данных |
--include-desktop |
собрать заодно приложение Desktop |
--non-interactive |
пропустить всё, что требует ответа человека |
Полный список печатает сам установщик по --help.
Установка от непривилегированного пользователя
Служебная учётная запись без sudo поддержана. Единственное место на пути
установки, которому действительно нужен root, — доустановка системных
библиотек для Chromium. Установщик сам определяет отсутствие sudo, ставит
Chromium в кэш этого пользователя и печатает точную команду для администратора.
Если браузерные инструменты не нужны вовсе, шаг снимается флагом
--skip-browser.
Служебные учётные записи часто имеют урезанный PATH без ~/.local/bin.
Тогда либо добавьте его в профиль пользователя, либо положите симлинк на
пусковой файл в системный каталог.
Установка из исходников
Для разработки или работы с конкретной веткой:
git clone https://github.com/digitable-lol/digit.git
cd digit
uv venv venv --python 3.11
uv pip install --python venv/bin/python -e '.[all]'
venv/bin/digit
Важная тонкость: запускать надо именно venv/bin/digit. Файл digit в корне
репозитория, запущенный системным Python, падает с
ModuleNotFoundError: No module named 'dotenv' — это не поломка установки, а
не тот интерпретатор.
Проверка
digit doctor
Проверяет конфигурацию и зависимости и называет, чего не хватает и как это
починить. digit doctor --fix пытается исправить то, что чинится
автоматически.
Если после установки оболочка отвечает digit: command not found —
перезагрузите её (source ~/.bashrc) или проверьте, что ~/.local/bin есть
в PATH.
Чего на этой странице нет
Мы описали то, что проверяли сами на Linux. Специфика Termux, Nix и NixOS, нативного Windows и WSL2 разобрана подробнее в английской документации: Installation, Platform Support. Раскладка каталогов и адреса установщика там те же — расходится только объём подробностей по платформам.
