Installing Digit
Digit is installed from the command line. There is no need to download a separate Desktop distribution: the application is built from the same installation – either immediately with the flag --include-desktop, or later, during the first digit desktop.
All channels lead to their own repository digitable-lol/digit, and not to the
upstream installation channel. This is important in practice: digit update pulls
updates from there, and an installation set up with someone else’s script would be updated
with someone else’s code.
One team
macOS via Homebrew:
brew install digitable-lol/tap/digit
Linux, macOS, WSL2, and 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)
After installation, restart the shell environment and run the wizard:
source ~/.bashrc # или ~/.zshrc
digit setup
digit
What happens next is on the page “First Launch”.
What the installer does
It clones the repository, creates a separate virtual environment, installs
the missing dependencies, and starts the digit command in the user’s
PATH.
A subsequent run updates the existing installation without overwriting
user settings.
From the dependencies, it installs the following itself: uv, Python 3.11, Node.js 22 (browser automation and WhatsApp bridge), ripgrep, ffmpeg.
What you need to have in advance: git. On Linux, you also need curl and xz-utils
(Node.js is downloaded as an archive .tar.xz). To build the Desktop version, you also need g++ – on Debian and Ubuntu, this is build-essential.
Where everything is stored
The layout depends on whether you are configuring it for a regular user or for root.
| Installation | Code | Command digit |
Data |
|---|---|---|---|
| User | ~/.digit/digit/ |
~/.local/bin/digit (symlink) |
~/.digit/ |
System (from root) |
/usr/local/lib/digit/ |
/usr/local/bin/digit |
/root/.digit/ or $DIGIT_HOME |
A system layout is needed where a single installation serves multiple
users: the code itself is shared, but each user has their own settings, skills, and sessions — in
their ~/.digit or in a clearly defined DIGIT_HOME.
The data catalog looks like this:
~/.digit/
├── config.yaml настройки
├── .env ключи и секреты
├── SOUL.md постоянные указания агенту
├── memories/ память
├── sessions/ переписки
├── skills/ навыки
└── digit/ сам код (при пользовательской установке)
Digit does not automatically import data from another agent here, even if it finds it nearby: there may be other people’s keys and other people’s memory. On the first launch, it will show the transfer command, but it will not execute it itself.
Installer Flags
Passed after bash -s --:
curl -fsSL …/install.sh | bash -s -- --skip-browser --skip-setup
| Flag | What it does |
|---|---|
--skip-setup |
Do not run the setup wizard |
--skip-browser |
Do not install Playwright and Chromium (browser tools will not work) |
--no-venv |
Do not create a virtual environment |
--no-skills |
Do not include built-in skills – neither now nor in future updates |
--branch ИМЯ |
Install not main, but another branch |
--commit SHA |
Pin to a specific commit |
--dir ПУТЬ |
Installation directory |
--digit-home ПУТЬ |
Data directory |
--include-desktop |
Build the Desktop application as well |
--non-interactive |
Skip everything that requires human input |
The complete list is printed by the installer itself via --help.
Installation as a non-privileged user
The service account without sudo is supported. The only place in the installation
process that actually needs root is the post-installation of system libraries
for Chromium. The installer itself detects the absence of sudo, installs
Chromium in the cache of this user, and prints the exact command for the administrator.
If browser tools are not needed at all, the step is removed using the flag
--skip-browser.
Service accounts often have a reduced PATH without ~/.local/bin.
Then either add it to the user profile or place a symlink to the startup file in the system directory.
Installation from source code
To develop or work with a specific branch:
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
An important nuance: you need to run exactly venv/bin/digit. The file digit in the root of the repository, when run with system Python, fails with ModuleNotFoundError: No module named 'dotenv' — this is not a broken installation, but the wrong interpreter.
Check
digit doctor
It checks the configuration and dependencies and indicates what is missing and how to fix it. digit doctor --fix attempts to fix what can be fixed automatically.
If the shell responds with digit: command not found after installation,
reboot it (source ~/.bashrc) or check that ~/.local/bin is present
in PATH.
What you won’t find on this page
We described what we tested ourselves on Linux. The specifics of Termux, Nix, and NixOS, native Windows, and WSL2 are discussed in more detail in the English documentation: Installation, Platform Support. The directory layout and installer addresses are the same there; only the amount of detail per platform differs.
