nanopub

The nanopub library provides a high-level, user-friendly Python interface for searching, publishing and retracting nanopublications.

Nanopublications are a formalized and machine-readable way of communicating the smallest possible units of publishable information. See the documentation for more information.

Documentation

Checkout the user documentation 📖

Setup

Install using pip:

pip install nanopub

To publish to the nanopublication network you need to set up your profile. This allows the nanopublication services to identify you. Run the following command in the terminal:

np setup

This will ask you a few questions, then it will use that information to add and store RSA keys to sign your nanopublications with, (optionally) publish a nanopublication with your name and ORCID iD to declare that you are using these RSA keys, and store your ORCID iD to automatically add as author to the provenance of any nanopublication you will publish using this library.

Quick Start

Publishing nanopublications

from rdflib import Graph
from nanopub import Nanopub, NanopubConf, load_profile

# 1. Create the config
np_conf = NanopubConf(
    use_test_server=True,
    profile=load_profile(),  # Loads the user profile that was created with `np setup`
    add_prov_generated_time=True,
    attribute_publication_to_profile=True,
)

# 2. Construct a desired assertion (a graph of RDF triples) using rdflib
my_assertion = Graph()
my_assertion.add((
    rdflib.URIRef('www.example.org/timbernerslee'),
    rdflib.RDF.type,
    rdflib.FOAF.Person
))

# 2. Make a Nanopub object with this assertion
np = Nanopub(
    conf=np_conf,
    assertion=my_assertion
)

# 3. Publish the Nanopub object
np.publish()
print(np)

Searching for nanopublications

from nanopub import NanopubClient

# Search for all nanopublications containing the text 'fair'
client = NanopubClient()
results = client.find_nanopubs_with_text('fair')
print(results)

Fetching nanopublications and inspecting them

# Fetch the nanopublication at the specified URI
publication = client.fetch('http://purl.org/np/RApJG4fwj0szOMBMiYGmYvd5MCtRle6VbwkMJUb1SxxDM')

# Print the RDF contents of the nanopublication
print(publication)

# Iterate through all triples in the assertion graph
for s, p, o in publication.assertion:
    print(s, p, o)

Development

See the development page on the documentation website.

Tests

To run tests:

Install dependencies (if not already installed):

uv sync

Run tests:

uv run pytest

Test coverage

Run the tests with coverage tracking:

uv run pytest --cov

View a terminal summary:

uv run coverage report

Or generate a detailed HTML report

uv run coverage html

License

nanopub is free software under the Apache License. See LICENSE.

Copyright

Metadata

Release files for nanopub 2.2.2

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

Source distribution (sdist)

Source distribution for nanopub 2.2.2
File	Size	Uploaded
nanopub-2.2.2.tar.gz	1.0 MB	Jun 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for nanopub 2.2.2
File	Interpreter	ABI	Platform	Reset
nanopub-2.2.2-py3-none-any.whl 59.0 kB Jun 23, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / nanopub-2.2.2.tar.gz

Download URL	nanopub-2.2.2.tar.gz
Size	1.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`086e9b49fe24bfc67bedaf108a74008f6e50a9af9ad66b6364250f00cfbdd30e`
BLAKE2b-256 checksum How to use checksums	`bff93440d62f724465bb9a6cb6198f6ff11a66e97d63f71092633e2dd33abc8d`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / nanopub-2.2.2-py3-none-any.whl

Download URL	nanopub-2.2.2-py3-none-any.whl
Size	59.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6bfdf46de17f4b8c92427323feec0cf92d9923f98200800aed475c1fb7b445de`
BLAKE2b-256 checksum How to use checksums	`9820a8b06d5bda659b8ece730b07d190d6937f034eda0cafe3d2b712fac0f4b6`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`