Running Locally

If you'd rather not use GitHub Codespaces, you can run the workshop locally on your own machine by following the steps below.

We recommend using uv for dependencies as it is much faster and automatically manages a .venv for you.

However, you can also install dependencies with plain pip if you prefer.

1. Cloning the repository

Clone the repository to your machine:

git clone https://github.com/acceleratescience/hands-on-llms
cd hands-on-llms

Alternatively, if you're using an IDE such as VS Code or PyCharm, you can paste the repository URL directly into the IDE's respective clone repository UI.

2. Installing dependencies with uv (preferred)

Windows (Powershell)

Install uv if needed:

irm https://astral.sh/uv/install.ps1 | iex

Create the virtual environment and install dependencies:

uv sync

Finally, activate the environment:

.\.venv\Scripts\activate

macOS / Linux

Install uv if needed:

curl -LsSf https://astral.sh/uv/install.sh | sh

Create the virtual environment and install dependencies:

uv sync

Finally, activate the environment:

source .venv/bin/activate

3. Installing dependencies with pip (alternative)

Windows (Powershell)

Create and activate an empty virtual environment:

python3 -m hands-on-llms .venv
.\.venv\Scripts\activate

Finally, install dependencies to virtual environment:

pip install .

macOS / Linux

Create and activate an empty virtual environment:

python3 -m hands-on-llms .venv
source .venv\bin\activate

Finally, install dependencies to virtual environment:

pip install .