Skip to main content

Lion's Librarian

A graphical registry editor for Librarian2 resource registries.


Lion's Librarian screenshot


What is it?

Lion's Librarian is a desktop GUI for editing Librarian2 resource registries — JSON files that catalogue resources like files, folders, URLs, and programs with structured metadata (purpose, tags, type, location, and more).

Think of it as a personal card catalogue: each entry describes one resource and where to find it, and the registry is the collection. Lion's Librarian makes it easy to browse, add, edit, reorder, and delete entries without hand-editing JSON.

Why would you want it?

The primary purpose is to maintain a single resource you can point LLMs at. Instead of explaining your environment to every new AI session — what files exist, where tools live, what each thing is for — you keep one registry file that answers all of those questions. Point an LLM at it and it immediately knows what's around and where to find it.

Beyond that:

  • You maintain a collection of documents, specs, datasets, or tools and want a structured index of them
  • You work with Patchboard components and want to emit registry entries onto the message bus
  • You want a lightweight alternative to a database for personal resource management
  • You prefer a form-based editor to raw JSON but still want direct access when needed (Ctrl+J toggles between form and raw JSON views)

Installation

Requires Python 3.10 or later.

pip install lions-librarian

Running

librarian

To open a specific registry file on launch:

librarian --path.registry path/to/registry.json

To configure the default registry path persistently:

librarian set path.registry path/to/registry.json

Basic usage

Action How
Add an entry Entry → Add File / Folder / URL / Program
Edit an entry Select it in the index, edit fields, press Ctrl+Enter or Apply
Save Ctrl+S
Open a registry Ctrl+O
Toggle form / raw JSON Ctrl+J
Reorder entries Ctrl+Up / Ctrl+Down
Delete an entry Select it, press Delete
Emit to Patchboard Ctrl+E

Configuration

Configuration is stored in .librarian2/config.json in your working directory. Use the built-in set command to adjust settings:

librarian set path.registry path/to/registry.json
librarian set patchboard.title "My Librarian"
librarian set patchboard.pollinginterval 1000
librarian keys

Metadata

Release files for lions-librarian 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lions-librarian 0.1.3
File Size Uploaded Provenance Actions
lions_librarian-0.1.3.tar.gz 29.9 kB Without provenance Details for lions_librarian-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lions-librarian 0.1.3
File Interpreter ABI Platform Actions
lions_librarian-0.1.3-py3-none-any.whl Python 3 none any Details for lions_librarian-0.1.3-py3-none-any.whl

Total release size: 70.5 kB

Release files / lions_librarian-0.1.3.tar.gz

Download URL lions_librarian-0.1.3.tar.gz
Size 29.9 kB
Tags Source
SHA-256 checksum
How to use checksums
0857ad40f5727702a455e43724d18339b415582758168f6fd43fb47ff5546a87
BLAKE2b-256 checksum
How to use checksums
003317dc1d5cf9cb760ecdd61beae660ed776036c4efbf92c7f42a0ebbd3e60c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / lions_librarian-0.1.3-py3-none-any.whl

Download URL lions_librarian-0.1.3-py3-none-any.whl
Size 40.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
35e407cef654820b099bfc67d059d251320afe209c1ef4353f818af9719a1cb5
BLAKE2b-256 checksum
How to use checksums
221d96908700a0f273a660630c3f6660ad393be810bec722d1c26dfc64392299
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Security for lions-librarian 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page