Welcome to the Annif usage documentation!

Get started with Annif, understand system requirements, and learn about supported corpus formats and configuration options.

• Getting started: The first steps
• System requirements: OS, hardware, and dependencies
• Corpus formats: Supported input and vocabulary formats
• Project configuration: How to set up and manage projects
• Optional features and dependencies: Some Annif features and backends need installing extra dependencies
• Backward compatibility between releases: What parts of Annif can and cannot change
• Architecture: Overview of Annif’s design

Guides for running Annif in production environments.

• Usage with Docker: Containerized deployment
• Running as a WSGI service: Deployment as a traditional web service

Explore the different ways to interact with Annif.

• Command line interface: For Annif projects administration
• Web user interface: For testing and simple end-user usage
• REST API: For integrating other systems

Features to tweak text inputs and help in workflows.

• Analyzers: Tokenization, stemming, etc.
• Transforms: Truncation and language filtering
• Language detection: Automatic language identification with CLI or API methods
• 🤗 Hugging Face Hub integration: Share and reuse models via Hugging Face

Tips and tricks for improving results.

• Achieving good results: Best practices
• Reusing preprocessed training data: Save time and resources
• Generating synthetic training data: Augment your datasets

Annif supports a variety of backends (algorithms) for different use cases. See a comparison table and each backend’s page for details and configuration options.

• TF-IDF
• fastText
• Omikuji
• MLLM
• STWFSA
• YAKE
• SVC
• Ensemble
• PAV
• nn_ensemble
• HTTP
• Dummy

For contributors.

• Development flow, branches and tags: Workflow and versioning
• Release process: How to make a new release
• Creating a new backend: Extend Annif with new algorithms

• Annif-users mailing list/forum: Community support ↗️
• GitHub Issues: Create an issue here to report bugs or request features ↗️
• Security Policy: Guidelines for reporting vulnerabilities and security issues ↗️

Getting started →