DISTRIBUTED_SYSTEM_INSTALL.md

Distributed System Install Guide

Windows Install

• I recommend using Winget or Scoop, go with Scoop if you don’t want UAC pop-ups, to install and organize packages on Windows versus manually installing and tracking

0. Install and uv package manager

uv repo An extremely fast Python package and project manager, written in Rust.

Features

• Install uv with standalone installers:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Or, from PyPI:

# With pip.
pip install uv

# Or pipx.
pipx install uv

Or, from winget-cli or Scoop:

# Or with winget or scoop
winget install --id=astral-sh.uv  -e

scoop install main/uv

wsl.exe --update

1. Docker Desktop with Cli integration

scoop bucket add main
scoop install main/docker-compose

2. Cassandra Runbook

• No changes.

3. Python Libraries for Cassandra Runbook

uv python install 3.11 3.13 3.14
uv venv --python 3.11
source .venv/bin/activate
uv pip install cassandra-driver

4. Kafka and Zookeeper Runbook

5. Postgres and pgvector

6. Ollama Runbook

MacOS Installation

• This guide is a supplement to the Runbooks by using package managers to organize your development environment. Homebrew is a package manager to organize

• I recommend using uv instead of pip to manage Python packages and environments.

• Open a terminal app (or iterm2) and enter the commands from the command line and not through VSCode.

0. Install Homebrew and uv package managers

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

1. Docker Desktop with Cli integration

brew install --cask docker
docker --version

• uv is fast Python package and project manager written in Rust

brew install uv

2. Cassandra Runbook

mkdir -p ~/Documents/dev/CSC545-Spring-2026 && cd ~/Documents/dev/CSC545-Spring-2026/

docker pull cassandra:latest
docker network create cassandra
docker run -d --name cassandra --hostname cassandra --network cassandra -p 9042:9042 cassandra:latest

docker run --rm --network cassandra -v "$(pwd)/data.cql:/scripts/data.cql" -e CQLSH_HOST=cassandra -e CQLSH_PORT=9042 -e CQLVERSION=3.4.7 nuvo/docker-cqlsh

docker ps
docker exec -it cassandra cqlsh

3. Python Libraries for Cassandra Runbook

• You have to be connected through a secure connection for python installers to connect to the servers

uv python install 3.11 3.13 3.14
uv venv --python 3.11
source .venv/bin/activate
uv python pin 3.11 # Pinned `.python-version` to `3.11`

uv pip install cassandra-driver

4. Kafka and Zookeeper Runbook

docker compose up -d # Start detached
docker compose ps # Verify running
docker compose logs kafka # Check start up

uv pip install numpy psycopg2-binary pgvector

5. Postgres and pgvector

docker compose -f docker-compose-pg.yml up -d
docker cp setup.sql pgvector:/tmp/
docker exec pgvector psql -U pguser -d vectordb -f /tmp/setup.sql

6. Ollama Runbook

brew install ollama
ollama pull <model>
ollama run <model>
uv pip install ollama