Step 3: Duckietown Shell Installation#

The Duckietown Shell is a command-line interface (CLI) program that provides all of the necessary Duckietown operations, such as

  • Updating a Duckiebot

  • Driving a Duckiebot with a virtual keyboard

  • Viewing the camera stream of a Duckiebot from a graphical app

  • Using our learning experiences

  • (and more!)

1) Install the Duckietown Shell (dts)

Install the Duckietown Shell using the following command,

pip3 install --no-cache-dir --user --upgrade duckietown-shell

2) Source dts

Make sure your system can find local binaries by adding the following to your .bashrc file.

Attention

If you are using zsh, replace the .bashrc in the commands below with .zshrc instead.

export PATH=~/.local/bin:${PATH}

Then source the updates to your current shell or restart your shell.

source ~/.bashrc

Checkpoint ✅

To confirm that dts was installed successfully, run the following test

Test

which dts

Expected Result

This should output a path ending in dts.

Warning

This configuration is not officially supported. We recommend using the Ubuntu Operating System for an optimal experience.

The Duckietown Shell is a command-line interface (CLI) program that provides all of the necessary Duckietown operations, such as

  • Updating a Duckiebot

  • Driving a Duckiebot with a virtual keyboard

  • Viewing the camera stream of a Duckiebot from a graphical app

  • Using our learning experiences

  • (and more!)

1) Install the Duckietown Shell (dts)

Install the Duckietown Shell using the following command,

pip3 install --no-cache-dir --user --upgrade duckietown-shell

2) Source dts

Make sure your system can find local dts binaries by adding the following to your .bashrc file.

Attention

If you are using zsh, replace the .bashrc in the commands below with .zshrc instead.

export PATH=~/.local/bin:${PATH}

Then source the updates to your current shell

source ~/.bashrc

Attention

If this does not work, try using .bash_profile and/or export PATH=~/Library/Python/VERSION/bin:${PATH} instead, where VERSION is your Python version.

If you are unsure of your Python version, or have multiple, try the following:

find ~/Library/Python   -name 'dts' -type f -exec dirname {} \;

The output, if successful, can be used to set the PATH variable.

Checkpoint ✅

You can now check that dts was installed with the following test

Test

which dts

Expected Result

This should output a path ending in dts. If there is no output, then the dts executables are not located where PATH is pointing. Try one of the PATH alternatives above.

Windows

Warning

This configuration is not officially supported. We recommend using the Ubuntu Operating System for an optimal experience.

The Duckietown Shell is a command-line interface (CLI) program that provides all of the necessary Duckietown operations, such as

  • Updating a Duckiebot

  • Driving a Duckiebot with a virtual keyboard

  • Viewing the camera stream of a Duckiebot from a graphical app

  • Using our learning experiences

  • (and more!)

You can install the Duckietown Shell in your Ubuntu WSL distro.

1) Install the Duckietown Shell (dts)

Install the Duckietown Shell using the following command,

pip3 install --no-cache-dir --user --upgrade duckietown-shell

Once installed open a new shell and follow the setup prompts.

Checkpoint ✅

To confirm that dts was installed successfully, run the following test

Test

which dts

Expected Result

This should output a path ending in dts.