Developer Installation#
Installing ActivitySim as a developer is as easy as just using it with uv.
Depending on what you are working on, you may want to check out a branch
other than the default main
. To do so, you can use a git switch
command
to any other existing branch name. If you want to start an new
branch, first create it with git branch cool-new-feature
and then switch
to it with git switch cool-new-feature
.
By default, uv installs projects in editable mode, such that changes to the source code are immediately reflected in the environment.
Important
If you add to the ActivitySim dependencies during development or remove, make
sure to use the uv add
and uv remove
commands so that the pyproject.toml
and uv.lock
files are updated correctly and your virtual environment is
updated.