invenio-pidbox

InvenioRDM integration for people and organization profile templates backed by the commonmeta SQLite store.

Features

• Ships people and organization profile templates for InvenioRDM
• Injects template context for /people/ and /organizations/ routes
• Reads ORCID and ROR profiles from the commonmeta SQLite store via commonmeta-py and commonmeta-rs
• Uses the pid_annotations cache layer instead of application-specific people or organizations tables
• Mirrors the profile integration approach used in rogue-scholar

Requirements

• Python 3.14+
• A commonmeta SQLite database readable through commonmeta-rs

The extension resolves profile data from the path configured in PIDBOX_SQLITE_PATH. Internally, commonmeta-rs reads pid_annotations records with source_id 4 for people (ORCID) and source_id 3 for organizations (ROR).

Installation

uv add invenio-pidbox

This package depends on commonmeta-py, commonmeta-rs, and invenio-app-rdm at runtime, so installing invenio-pidbox pulls in the profile backend automatically.

If the profile store lives outside the default commonmeta location, configure PIDBOX_SQLITE_PATH in your Invenio application.

How It Works

When a request path matches /people/ or /organizations/, the extension loads the corresponding commonmeta record from SQLite and exposes template-friendly objects such as person, organization, employment, identifiers, relations, location, orcid, ror, and search_config.

The extension also registers default profile routes and a country_name template filter so it can run against a standard invenio-app-rdm installation.

Development

uv sync --extra tests
uv run pytest

Entry points

License

MIT