usr-wwelsh docs
Documentation for every public usr-wwelsh repo, in one searchable place
Hi, I’m William Welsh. I build free, open, offline-first tools, mostly single binaries you can run on your own hardware with no accounts, API keys or cloud. Everything is MIT.
This site gathers the docs for every public usr-wwelsh repo. Each project’s README and docs/ folder get pulled in nightly, so it stays in sync with GitHub.
Search is semantic, so you can describe what you want instead of guessing a repo name.
# Try searching for
run Hugging Face models locally on CPUdownload music from YouTube and stream it on my phonestatus badge showing my server's CPU and RAMbuild a Doom-style game in the browser without codedoes hostile feedback make an LLM worse at reasoningsummaries of new arXiv papers without an API keysummarize my GitHub commits with an LLMrun several AI agents in parallel on a kanban board
# What’s here
- AI & agents: run your own AI model server, orchestrate agents, summarize research papers, test how LLMs behave and match your code to job listings with turbolab, fanoutd, Research-Digest, emotional-contamination and jobSeeker
- Tools & apps: botdocs builds this site, Dependadocs flags docs a PR made stale, git-digest journals your commits, init-launcher is a terminal-style Android launcher, zweek-lisp is an archived Lisp-to-C++ experiment and cde-wallpaper is a CDE wallpaper picker for KDE Plasma
- Games & creative: a no-code Doom-style editor, an ARPG, a 3D museum of GitHub, AI karaoke and an arcade Paperboy in Blopple, path-of-python, git-gallery, karaoke-maker and amazin-man
- Self-hosting: run your own music streamer, social network, status badges, a game night league tracker and a music mood analysis API with omniMux, socialChat, vitalSVG, dominion-tracker and Mood-Detector
# Elsewhere
Documentation
Amazin Man
Modern Paperboy. Built with LÖVE for an arcade machine I'm making with friends.
Answerable
Answerable makes any website ready for the agent-native web:
Answerable Connect (WordPress plugin)
Makes a WordPress site agent-discoverable without server access, DNS changes, or an IT team. Install like any other plugin, paste your running Answerable…
Blopple
A no-code, browser-based Doom-style map/enemy/music editor that exports standalone playable web games small enough for itch.io. Maps are grid-based with three…
Botdocs
Convert markdown documentation into beautiful static sites with AI-powered semantic search — no backend required.
cde-wallpaper
A Rust/GTK4 wallpaper picker for Wayland that reads authentic CDE (Common Desktop Environment) wallpaper files (.xbm, .xpm) and applies them via KDE Plasma's…
Dependadocs
In your repo: Settings → Secrets and variables → Actions → New repository secret
digest-finetune
GRPO on digest-sft3 regressed rather than improved it (0.6844 vs sft3's 0.8700, matched sampled eval — see Weights) even after the reward had been fuzzed…
Dominion Tracker
Self-hosted league tracker for Dominion game nights. Vanilla JS frontend, Express backend, single-file SQLite database — no build step, no cloud.
Emotional Context Contamination in Large Language Models
This experiment investigates whether emotional context from earlier conversational turns affects LLM behavior in subsequent introspective queries. Testing two…
Emotional Context Contamination in LLMs
Testing whether emotional tone in conversations affects LLM reasoning quality.
Usage Guide
Results saved to proberesults/: - JSON files with full conversation data - HTML visualizations (open probe1results.html, etc.)
fanoutd
Multi-agent orchestrator with a kanban board, driven by any OpenAI-compatible model provider — hosted or local.
Roadmap
Steps 1 (portability + auth), 2 (the fanout CLI), 4 (idea breakdown) and 5 (criteria + review) are done; what they shipped is in the README and what they got…
git-digest
It fetches your recent commits and renders a structured markdown digest: either an LLM writes a retrospective developer-journal entry from a grounded prompt…
Git Gallery
A 3D museum built from your GitHub profile. Walk through a lobby displaying your contribution graph, then explore a hallway of rooms — one per repository —…
Go Fundamentals
A Go program is a package, a set of imports, and a list of declarations. There is no implicit global scope beyond the package, no header files, and exactly…
Functions & Error Handling
Go functions can return multiple values, and idiomatic Go uses that to make failure part of a function's signature instead of an exception that silently…
Slices, Arrays & Maps
Arrays in Go have a fixed length baked into their type — [5]int and [10]int are different types. Almost nobody uses arrays directly; the collection type you…
Structs, Methods & Composition
Go has no classes. A struct groups fields together, and a method is a function with an extra receiver argument bound to a type — that's the entire toolkit…
Interfaces & Polymorphism
Go interfaces are satisfied implicitly — there's no implements keyword. If a type has the methods an interface asks for, it satisfies that interface…
Generics
Before generics, writing a container or algorithm that worked for any type meant either copy-pasting per type or falling back to interface{} and losing type…
Concurrency I: Goroutines & Channels
Go's concurrency is built into the language, not bolted on as a library. A go statement launches a function to run concurrently, and a channel is a typed pipe…
Concurrency II: Synchronization & Context
Channels aren't the only tool for concurrent code. Sometimes goroutines need to share a plain variable, which needs a mutex to stay safe; sometimes a whole…
Data Structures & Algorithms in Go
Go's standard library gives you a slice and a map — it doesn't ship a linked list, tree, or heap type. Building one is just structs and pointers, the same…
Testing, Tooling & Capstone
Go ships a testing framework in the standard library instead of leaving it to a third party, and the tooling built around it — go test, go vet, gofmt — is a…
Go, by Doing
Ten chapters. Each one is a short lesson followed by a real function to implement, checked against real test cases, entirely in this page — no signup, no…
Go, by Doing
A ten-chapter, browser-based Go course. Each chapter is a short lesson followed by a function to implement, checked against real test cases entirely…
Init Launcher
A minimal, stripped-metal style Android launcher with system monitoring capabilities inspired by terminal aesthetics and neofetch.
jobSeeker
A local-first job-hunting engine that indexes your GitHub portfolio into a vector database, scrapes daily job listings, and generates hyper-personalized…
Contributing to Karaoke Maker
Thank you for your interest in contributing to Karaoke Maker! This document provides guidelines and information for contributors.
GPU Troubleshooting
This means your GPU is too old for the version of PyTorch installed.
Quick Start Guide
Get up and running with Karaoke Maker in 5 minutes!
Karaoke Maker
A user-friendly GUI application for creating karaoke videos from MP3 files. Select an MP3, let AI transcribe the lyrics, and generate a karaoke video with…
Contributing to Mood Detector
Thank you for your interest in contributing to Mood Detector! We welcome contributions from the community.
Mood Detector API Reference
How Mood Detector Works
This document explains the technical details of how Mood Detector analyzes audio files to determine musical mood.
Integration Guide
This guide covers how to integrate Mood Detector into your projects using different methods.
Quick Start Guide
This guide will help you get started with Mood Detector in just a few minutes.
🎵 Mood Detector
Analyze audio files to detect mood, tempo, energy, key, and genre characteristics—without sending data to third parties or paying per-request fees.
Auto-update (opt-in)
omniMux's web UI can show an "update available" banner with a one-line changelog, and a button that pulls + rebuilds on your host. Running the install step…
omniMux
A self-hosted music server that lets you search YouTube, cache tracks to your library, and stream everything through a Spotify-like PWA. Built on top of…
omniMux — web
SvelteKit 5 + TypeScript PWA frontend for omniMux. Talks to the FastAPI backend in ../api and to Navidrome's Subsonic API for playback.
Building Path of Python - Windows Executable
This document explains how to build Path of Python into a standalone Windows executable.
Complete Understanding of the Game Code
The BaseGameplayScene class handles the loading and drawing of tilemaps. Here's a breakdown of the process:
Dungeon Generator GUI
The Dungeon Generator GUI is a tool for creating new dungeons in the game. It allows users to customize various aspects of the dungeon, such as its size…
Path of Python: A Post-Apocalyptic ARPG
"Path of Python" is a top-down Action RPG (ARPG) set in a grim, post-apocalyptic future of 2300. Humanity's golden utopia was shattered when a rogue AI…
Path of Python
A top-down post-apocalyptic ARPG inspired by Path of Exile. Fast, mouse-driven combat with intentionally minimal 2D graphics.
Updates
Research Digest
Offline-first arXiv digest. Fetching, scoring, and summarization run in your browser — papers are summarized extractively (key sentences selected, not…
socialChat
Open http://localhost:3000. A SQLite database is created automatically on first run.
socialChat Setup Guide
No setup needed. A db file will be created automatically on first run at ./db.
turbolab
Self-hosted AI model server. Single binary, no cloud, no API keys. Run HuggingFace models locally with a web chat UI and an OpenAI-compatible API.
VitalSVG
Live SVG badges for your infrastructure. Like github-readme-stats, but for your actual servers.
Zweek
🔒 This site's search assistant runs a local AI model in your browser — no cloud AI, no tracking. See the ℹ️ in the chat panel for details.