Hero-Book

This tiny project is a solver for Hero Books that are written in french (les livres dont vous êtes le héros).
The approach consists in parsing a pdf file into a structured set of episodes, and representing this set as a Directed Graph. Solving the book then only amounts to finding the shortest path between the beginning and end episode of the book.

How to use it

1. Installation

This project uses python 3.11 as core interpreter, conda as environment manager, and poetry 1.8 as dependency manager.
Create a new conda environment

conda env create -f environment.yml

Activate the environment

conda activate herobook

Move to the project directory and install the project dependencies

poetry install

2. Usage

Run the streamlit app:

streamlit run app.py

You can play with both using some pdfs found in data/pdfs. Enjoy !