htr_demo / .github /README.md
Gabriel's picture
0.0.3 release with Trocr and compare support
c60ebd1

HTRFLOW: A demo app for HTR

We're thrilled to introduce HTRFLOW, our demonstration platform that brings to life the process of transcribing Swedish handwritten documents from the 17th to the 19th century.

HTRFLOW Image

HTRFLOW is designed to provide users with a step-by-step visualization of the HTR-process, and offer non-expert users an inside look into the workings of an AI-transcription pipeline. At the moment HTRFLOW is mainly a demo-application. It’s not intended for production, but instead to showcase the immense possibilities that HTR-technology is opening up for cultural heritage institutions around the world.

All code is open-source, all our models are on Hugging Face and are free to use, and all data will be made available for download and use on Hugging Face as well.

HTRFLOW is more than just a demo; it's a testament to the advancement of open source development of HTR. As we progress, the app will be renamed into HTRFLOW.app and HTRFLOW will evolve into multiple parts. HTRFLOW will become our foundational library that will serve as the backbone for a range of applications in the transcription domain. Note that the backend (src) for the app will be rewritten and packaged to be more optimized under the project name HTR_SVEA (possibly renamed into HTRFLOW.core).

Run app

Use virtual env.

python3 -m venv .venv
source .venv/bin/activate

Install libraries with Makefile:

make install

With pip:

pip install -r requirements.txt

Run app with:

gradio app.py

Run with Docker

There are two options:

Run with Docker locally

Build container:

docker build --tag htrflow/htrflow-app .

Run container:

docker run -it -d --name htrflow-app -p 7000:7860  htrflow/htrflow-app:latest

Run with Docker with HF

You can also just run it from Hugging Face:

docker run -it -p 7860:7860 --platform=linux/amd64 --gpus all \
    -e registry.hf.space/riksarkivet-htr-demo:latest