Nix install (required for nix managed dimos)
You need to have nix installed and flakes enabled, official install docs recommended, but here is a quickstart:skip
# Install Nix https://nixos.org/download/
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
. /nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh
# make sure nix-flakes are enabled
mkdir -p "$HOME/.config/nix"; echo "experimental-features = nix-command flakes" >> "$HOME/.config/nix/nix.conf"
Using DimOS as a library
skip
mkdir myproject && cd myproject
# pull the flake (needed for nix develop outside the repo)
wget https://raw.githubusercontent.com/dimensionalOS/dimos/refs/heads/main/flake.nix
wget https://raw.githubusercontent.com/dimensionalOS/dimos/refs/heads/main/flake.lock
# enter the nix development shell (provides system deps)
nix develop
python3 -m venv .venv
source .venv/bin/activate
# install everything (depending on your use case you might not need all extras,
# check your respective platform guides)
pip install "dimos[misc,sim,visualization,agents,web,perception,unitree,manipulation,cpu]"
Developing on DimOS
skip
# this allows getting large files on-demand (and not pulling all immediately)
export GIT_LFS_SKIP_SMUDGE=1
git clone https://github.com/dimensionalOS/dimos.git
cd dimos
# enter the nix development shell (provides system deps)
nix develop
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[misc,sim,visualization,agents,web,perception,unitree,manipulation,cpu]"
# type check
mypy dimos
# tests (around a minute to run)
pytest --numprocesses=auto dimos