Conjugador is a web application that allows to search and display verbs forms building the content from the spelling dictionary.

How it works

1. extract.py reads diccionary file and extracts the verbs in JSON format (into data/jsons)
2. index_creation.py reads the jsons and creates multiple indices in Elasticsearch
3. FastAPI application at web/ serves the content

Git clone

To clone the repository and its submodules use:

git clone --recurse-submodules git@github.com:Softcatala/conjugador.git

Prerequisites

To both develop locally and build the image you need to have uv installed.

uv is a fast, modern integrated package and version manager for Python. This substitutes the need for separate tools like pyenv and pip.

To install uv, follow the official instructions.

Once installed, install the project dependencies into a virtual environment as follows:

uv python install $(cat .python-version) && uv sync

Docker

To create Docker image, from the root directory type:

make docker-build

Simple execution of the Docker image:

make docker-run

Test from the browser:

• Search: http://localhost:8000/search/cantar
• Index: http://localhost:8000/index/a
• Autocomplete: http://localhost:8000/autocomplete/cantari

How the system works

See document DEV.md (in Catalan)

License

Software

GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

Data

Same license that source projects.

Maintenance

Update dictionary & terms' definitions

Run:

make update-data

Contact

Contact Jordi Mas jmas@softcatala.org