Lion's Librarian
A graphical registry editor for Librarian2 resource registries.
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.