Backend: HTTP - NatLibFi/Annif GitHub Wiki

The http backend allows Annif to delegate subject suggestion requests to an external system via communicating it with REST API. The target system can be either another Annif instance or a compatible service that implements the necessary functionality: a suggest method that accepts a document and returns a list of suggested subjects.

See for example MauiServer.

Example configuration

[http-en]
name=HTTP English
language=en
backend=http
endpoint=http://localhost:5000/v1/projects/yso-en/suggest
vocab=yso

The endpoint setting specifies a URL where requests for subject suggestions are POSTed.

Usage

Load a vocabulary:

annif load-vocab yso /path/to/Annif-corpora/vocab/yso-skos.ttl

Training is not possible.

Test with a single document:

cat document.txt | annif suggest http-en

Evaluate a directory full of files in fulltext document corpus format:

annif eval http-en /path/to/documents/

← nn_ensemble | Dummy →