Skip to content
adnoctemPublic

About

Our Personal Pantry - a repository for local first applications managing personal data

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

pertry Logo

pertry

License go.mod version Language Testing GitHub Release GitHub Activity Bazel Renovate PreCommit

pertry is an open-source MIT-licensed collection of local-first command-line applications, written in Go. Each one is a single static executable with no runtime dependencies, published for Linux and Windows. The project is built using Google's Bazel build system in combination with their first-party Gazelle BUILD file generator.

📖 Overview

Years of bookmarks in a folder tree nobody can navigate? bookscape reads the export your browser already produces, collapses the duplicates, checks what is still reachable, classifies the rest into a small flat set of collections, and emits a document for import into Linkwarden - it reads one format and converts between none, so it is a filter rather than a converter. Tens of thousands of photographs in one directory from a phone backup? sicht sorts them by sifting: EXIF metadata and deterministic rules first, a local vision model only for what the rules cannot decide, a review pass for what the model was unsure about, and only then any file movement - recorded in a manifest that can be undone. Maintaining Terraform modules that are meant to cover a provider's whole API? formr lists every field of every provider resource and data source a module uses, says what the module does with each, and fails CI when that report goes stale.

Neither archive tool sends your archive anywhere. bookscape talks to the open web to find out whether a bookmarked page still answers, and to a cloud model only if you configure one; sicht runs its inference against a locally installed Ollama and is wired to nothing else, because an image archive holds other people's faces and documents as well as your own.

✨ TL;DR

# Install one application - bookscape, sicht or formr - for linux or windows, amd64
curl -fsSL https://github.com/adnoctem/pertry/releases/latest/download/sicht_linux_amd64.tar.gz \
  | sudo tar -xzf - -C /usr/local/bin sicht

# Or all of them at once
curl -fsSL https://github.com/adnoctem/pertry/releases/latest/download/pertry_linux_amd64.tar.gz \
  | sudo tar -xzf - -C /usr/local/bin bookscape sicht formr

# Then check what you got
sicht version

Prefer to check what you install first? Every release publishes a checksum file covering every tarball:

base=https://github.com/adnoctem/pertry/releases/latest/download
curl -fsSLO "$base/sicht_linux_amd64.tar.gz"
curl -fsSL "$base/CHECKSUMS_SHA256.txt" | sha256sum -c --ignore-missing
tar -xzf sicht_linux_amd64.tar.gz sicht

Linux and Windows are both supported, on amd64. The Windows build is not an afterthought: it is why this repository bans cgo outright, and the cross-compile for it is checked on every change. sicht additionally needs exiftool and a running Ollama - run sicht doctor, which reports on every one of its dependencies and says what to do about each. formr needs a terraform or tofu executable.

🛠️ Applications

Like most modern Go projects the executables are located within the cmd directory, each with its own README documenting how to install, configure and run it. Here's a quick-reference list as an overview:

  • bookscape: a bookmark archival and enrichment pipeline that emits for Linkwarden
  • sicht: a local-first iterative image sorter, with a vision model for what rules cannot decide
  • formr: a provider-schema coverage report and CI check for Terraform modules

All are pre-release. bookscape covers its whole pipeline; sicht scans, applies rules, classifies, reviews and moves files from the command line, and has no web interface yet; formr generates and checks reports, and has no exception annotations yet.

How each one works, what they share and where their limits are is described in the architecture.

🔃 Contributing

Refer to our documentation for contributors for building and testing, the repository layout, dependency rules, commit message formats and how a release is made.

📥 Maintainers

This project is owned and maintained by Ad Noctem Collective refer to the AUTHORS or CODEOWNERS for more information. You may also use the linked contact details to reach out directly.

©️ Copyright

About

Our Personal Pantry - a repository for local first applications managing personal data

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages