type check

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:

# 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

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

# 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