Two cooperating bugs we hit in production caused a Pillow version mismatch error on in-place upgrades. Documenting both so future projects do not reproduce them. - Section 4.3: removed the "delete .py, keep .pyc" snippet (no compileall step ever ran, so the dist shipped with no .py and no .pyc — every package's submodules were unimportable). Added a warning box and the correct compileall -b pattern. - Section 6: NSIS Core section now shows explicit RMDir /r of payload dirs before File /r. NSIS File /r is a merge, not a replace, so upgrades produce half-old/half-new site-packages. - Section 14: new troubleshooting entry "Pillow / package version mismatch on upgrade" with the symptom, both root causes, and a file-state table showing how the mismatch arises.
Claude Code Facts
Last updated: 2026-04-01
A collection of interesting and useful facts, tips, tools, and guides for working with Claude and Claude Code.
Contents
Claude Code Tools & Extensions
MCP servers, skills, and plugins that extend Claude Code — including Context7 (library docs) and AST Index (fast code search).
Gitea Release Workflow (Minimal)
Minimal Gitea Actions workflow: push a v* tag → create a Gitea release with optional RELEASE_NOTES.md. No builds, no artifacts — just a release entry.
CI/CD for Python Apps on Gitea
Reusable reference for building CI pipelines, release automation, and installer packaging for Python apps on Gitea — covering lint/test workflows, cross-compiled Windows builds (embedded Python + NSIS), Linux tarballs, Docker images, and Gitea REST API release management.
Windows Code Signing for Open-Source Projects
Review of code signing options for Windows executables — Azure Trusted Signing ($9.99/mo, immediate SmartScreen trust), SignPath.io (free but GitHub-only), SSL.com, Certum, and self-signed. Includes CI/CD integration examples for Gitea Actions.
Gitea Act Runner — Worker Capacity (TrueNAS)
How to configure parallel job capacity for Gitea Act Runner on TrueNAS. Covers the CONFIG_FILE env var requirement, custom config.yaml mount, and capacity tuning.