Edition No. 21

# Download the Linux build from the releases page:
#   https://github.com/pocketbase/pocketbase/releases/latest
# then unzip it and run it:
unzip pocketbase_*_linux_amd64.zip
./pocketbase serve
# It prints two addresses. Open the admin one in a browser and
# create the first account. That is the whole setup.
# To build it from source or use it as a Go library you need Go 1.25+:
go install github.com/pocketbase/pocketbase@latest

# The guided installer is the easiest route. It asks you questions
# and writes the files for you:
bash -c "$(curl --location --silent --show-error \
  https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
# By hand instead:
# 1. From https://github.com/paperless-ngx/paperless-ngx, in docker/compose/,
#    take ONE docker-compose.*.yml matching the database you want and save
#    it as docker-compose.yml. Pick the file with -tika in the name if you
#    also want Word documents read.
# 2. Take docker-compose.env and .env into the same folder.
# 3. Edit docker-compose.env. On Linux set USERMAP_UID and USERMAP_GID to
#    your own user and group, or the files it writes will not be yours.
docker compose pull
docker compose up -d

# Debian or Ubuntu, using the prebuilt binary from the releases page:
#   https://github.com/rustic-rs/rustic/releases/latest
# Or, if Rust is already on the machine:
cargo install --locked rustic-rs
# macOS:
brew install rustic
# Set up a store and take the first backup:
rustic -r /mnt/backup/grasppy init
rustic -r /mnt/backup/grasppy backup /var/www /etc
# The part people skip. Do it now, not later:
rustic -r /mnt/backup/grasppy snapshots
rustic -r /mnt/backup/grasppy restore latest /tmp/restore-test

# Debian or Ubuntu:
sudo apt-get install pspg
# Fedora:
sudo dnf install pspg
# macOS:
brew install pspg
# Switch it on for psql, permanently:
echo "export PSQL_PAGER='pspg'" >> ~/.bashrc
source ~/.bashrc
# Then just use psql as normal:
psql grasppy -c "SELECT * FROM documents LIMIT 200;"
# It also reads a CSV file directly:
pspg --csv export.csv

# Run it without installing anything (needs uv):
uvx oterm
# Or install it properly:
python3 -m venv venv && source venv/bin/activate
pip install oterm
oterm
# macOS:
brew install oterm
# You also need somewhere for the model to run. The usual free route:
#   https://ollama.com  — then:  ollama pull llama3.2
# Python 3.10 or newer is required.

# macOS or Linux with Homebrew (it pulls in ttyd and ffmpeg):
brew install vhs
# Or on Debian and Ubuntu, from the project's own package repository:
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key \
  | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" \
  | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install vhs ffmpeg
# Write your first tape and render it:
vhs new demo.tape
vhs demo.tape
# Or with no local installation at all:
docker run --rm -v $PWD:/vhs ghcr.io/charmbracelet/vhs demo.tape

# Try it with no installation at all (needs Node.js 18+):
npx @marp-team/marp-cli@latest slide-deck.md
# macOS:
brew install marp-cli
# Inside a project:
npm install --save-dev @marp-team/marp-cli
# Write slides, then export. Three dashes start a new slide:
npx @marp-team/marp-cli@latest slide-deck.md --pdf
npx @marp-team/marp-cli@latest slide-deck.md --pptx
# Edit and watch it rebuild in a browser:
npx @marp-team/marp-cli@latest -s slide-deck.md

# Inside an existing React project:
npm install --save @usewaypoint/email-builder
# Try the editor first, with nothing installed, at:
#   https://usewaypoint.github.io/email-builder-js/
# Or run the project's own example locally:
git clone https://github.com/usewaypoint/email-builder-js
cd email-builder-js
npm install
npm run dev

# ffmpeg must be on the machine first:
sudo apt install ffmpeg          # or: brew install ffmpeg
python3 -m venv venv && source venv/bin/activate
pip install pyannote.audio
# Then, once, in a browser:
# 1. Make an account at https://huggingface.co
# 2. Accept the conditions at
#    https://huggingface.co/pyannote/speaker-diarization-community-1
# 3. Create a token at https://huggingface.co/settings/tokens

python3 -m venv venv && source venv/bin/activate
pip install dspy
# Python 3.10 or newer is required (and below 3.15).
# The older package name dspy-ai is now only an alias. Install dspy.

python3 -m venv venv && source venv/bin/activate
pip install -U lib-pybroker
# Python 3.11 or newer. Note the package name: lib-pybroker.

# Nginx. Fetch the include file and point your server block at it:
sudo curl -o /etc/nginx/nginx-block-ai-bots.conf \
  https://raw.githubusercontent.com/ai-robots-txt/ai.robots.txt/main/nginx-block-ai-bots.conf
# Then inside your server { } block add:
#   include /etc/nginx/nginx-block-ai-bots.conf;
sudo nginx -t && sudo systemctl reload nginx
# The polite half, for any web server. Put this at the site root:
curl -o robots.txt \
  https://raw.githubusercontent.com/ai-robots-txt/ai.robots.txt/main/robots.txt
# To be told when the list changes, subscribe to:
#   https://github.com/ai-robots-txt/ai.robots.txt/releases.atom