Local Setup (without Docker)

If you prefer not to use Docker, you can install Tampio's dependencies natively. The tricky part is libvoikko and the Finnish morphological dictionary — the Docker path handles all of this for you, so that's recommended if you just want to try the examples.

Prerequisites

Python 3.8+
libvoikko — Finnish morphology library
python3-libvoikko — Python bindings for libvoikko
fi-x-morpho dictionary — the specific Finnish dictionary Tampio requires

Ubuntu / Debian

# Install libvoikko, Python bindings, and the base voikko-fi package
sudo apt-get update
sudo apt-get install -y libvoikko-dev voikko-fi python3 python3-libvoikko curl unzip

# Download the fi-x-morpho dictionary (not available via apt)
# This installs it system-wide; alternatively unzip to ~/.voikko/
curl -fsSL https://www.puimula.org/htp/testing/voikko-snapshot-v5/dict-morpho.zip \
    -o /tmp/dict-morpho.zip
sudo unzip /tmp/dict-morpho.zip -d /usr/lib/voikko
rm /tmp/dict-morpho.zip

Note: The voikko-fi apt package only ships mor-standard. Tampio requires the fi-x-morpho variant, which is why the manual download step is needed.

macOS

Install voikko via Homebrew:

brew install libvoikko
pip3 install libvoikko

Then download the dictionary manually:

mkdir -p ~/.voikko
curl -fsSL https://www.puimula.org/htp/testing/voikko-snapshot-v5/dict-morpho.zip \
    -o /tmp/dict-morpho.zip
unzip /tmp/dict-morpho.zip -d ~/.voikko
rm /tmp/dict-morpho.zip

macOS compatibility is not officially tested — if you run into issues, Docker is the reliable fallback.

Install Tampio

Tampio is not on PyPI. Clone it directly from GitHub:

git clone https://github.com/fergusq/tampio.git

Optionally add a wrapper so you can call tampio from anywhere:

echo '#!/bin/sh\npython3 /path/to/tampio/tampio.py "$@"' > /usr/local/bin/tampio
chmod +x /usr/local/bin/tampio

Verify

echo 'Kun nykyinen sivu avautuu, teksti "Hei!" näytetään käyttäjälle.' \
    | python3 tampio/tampio.py /dev/stdin

If you see HTML output, the setup is working.

Build the Examples

From the Tampiorama root:

# Override the Docker command with a direct tampio call
make TAMPIO="python3 /path/to/tampio/tampio.py -i -p"

Or compile manually:

python3 /path/to/tampio/tampio.py -i -p examples/basics/hello.itp > examples/basics/hello.html

2.4 KiB Raw Blame History