buvis-gems 0.11.1

BUVIS Python toolkit and CLI tools

buvis-gems

BUVIS Python toolkit and CLI tools, shipped as a single PyPI package.

Documentation

Install

Pre-built wheels for Linux (x64, ARM), macOS (ARM), and Windows (x64). Python 3.10+.

uv

uv tool install buvis-gems              # all 15 CLIs, no optional deps
uv tool install buvis-gems[bim]         # + jira & textual deps for bim
uv tool install buvis-gems[bim,muc]     # combine extras
uv tool install buvis-gems[all]         # all optional deps

pipx

pipx install buvis-gems                 # all 15 CLIs, no optional deps
pipx install 'buvis-gems[all]'          # all optional deps

mise

mise's experimental uvtool backend doesn't support extras. Use the pipx backend instead.

In ~/.config/mise/config.toml:

[tools]
"pipx:buvis-gems" = { version = "latest", extras = "all" }

Then run mise install.

Update

Any tool accepts --update to force-check PyPI and upgrade if a newer release is available:

dot --update

This prints buvis-gems X.Y.Z is up to date. or streams the installer upgrade output.

You can also upgrade manually with your package manager:

uv

uv tool upgrade buvis-gems

pipx

pipx upgrade buvis-gems

mise

mise upgrade pipx:buvis-gems

All 16 CLIs (bim, dot, fctracker, fren, hello-world, morph, muc, netscan, outlookctl, pidash, pinger, puc, readerctl, sysup, vuc, zseq) are always installed. Extras add optional dependencies some tools need:

Extra	Dep	Tool
bim	jira, textual, fpdf2	bim
bim-web	fastapi, uvicorn, watchfiles	bim (web UI)
doc	ocrmypdf, pdfminer.six, requests, Unidecode	bim (doc subsystem)
dot	textual	dot (TUI)
fren	python-slugify, Unidecode	fren
hello-world	pyfiglet	hello-world
morph	markdownify	morph
muc	ffmpeg-python	muc
pidash	textual, watchfiles	pidash
pinger	ping3	pinger
readerctl	requests	readerctl
all	all of the above	—

What's inside

Library (src/lib/buvis/pybase/) — shared adapters, CLI scaffolding, configuration, filesystem and formatting utilities, plus the zettel subsystem (domain logic, Jira integration, and a Rust extension via PyO3 for performance-critical parsing).

Tools (src/tools/) — 16 Click-based CLIs built on the library:

Tool	Purpose
bim	BUVIS InfoMesh (zettel integration)
dot	Dotfiles manager
fctracker	Foreign currency account tracker
fren	File renamer toolkit
hello_world	Sample script template
morph	File conversion toolkit
muc	Music collection tools
netscan	Network scanning tools
outlookctl	Outlook CLI
pidash	Autopilot PRD cycle dashboard
pinger	ICMP ping utilities
puc	Photo utility collection
readerctl	Readwise Reader CLI
sysup	System update tools
vuc	Video utility collection
zseq	Zettelsequence utilities