lesia 0.1.3

A library for automated directory translation

Translate directory library

A library and a CLI to manage the translation text writing projects (e.g: LaTeX, Markdown, Jupyter, MyST, Typst). The library is aimed to simplify and automate the translation process and compiling of the translated version of the documents.

Credits

• Nicolas M. Thiéry - for supervising this project.
• LISN (Université Paris-Saclay) - for financing the internship and providing workspace.
• CentraleSupélec - for financing the project.

Important

The library is still in an early phase of development and may have bugs and unimplemented features

For French users and members of Université Paris-Saclay

This CLI supports ilaas (French independent LLM service provider) and LLMs on MyDocker that any member of Paris-Saclay cluster can access for free.

In order to translate documents on MyDocker open MyDocker docs and create JupyterLab et Python instance and you will be able to open jupyter in your browser. Then, open terminal (important: in the jupyter tab in web) – you will be able to install CLI and translate your document.

For using open-source llms on jupyter: run translate-dir set-llm aristoteonmydocker <model> command. As of April 24, the next models are availible:

• gemma-4-31b
• gpt-oss-120b
• llama-3.1-8b
• llama-3.3-70b
• mistral-medium-250523
• mistral-small-3.2-24b
• qwen-3.6-35b-instruct

Features

• Project creation
• Source language and the source folder to translate setting
• Target language addition
• Project files syncing (between languages)
• Translation cache
• File translation
• Translation correction

The profound explanation of the logic and algorithms of the tool can be found here

Installation

For CLI usage

1. Clone the repo: git clone https://github.com/DobbiKov/lesia
2. Enter to the directory: cd lesia
3. Install the CLI: uv tool install -e .
4. Use it: translate-dir

For in-project library usage

1. Clone the repo: git clone https://github.com/DobbiKov/lesia
2. Enter to your project where you want to use this library (cd <your_project_path>)
3. Install the library as a dependency using pip: pip install <path_to_the_library_directory>
4. Enjoy!

For the library development and contribution uses

1. Ensure you have uv tool installed (visit their site for the installation guide)
2. Clone the repo: git clone https://github.com/DobbiKov/lesia
3. Enter cd lesia
4. Install dependencies uv sync
5. Enjoy

Testing

1. Install the dependencies using uv sync
2. Run tests: uv run pytest

Documentation

• Library API reference
• CLI documentation
• Architecture and algorithms
• Typst parsing and implementation

ToDo

📚 Citation

If you use this software in your research or writing, please cite it as follows:

@software{korotenko-sci-trans-git,
    author = {Yehor Korotenko},
    title = {sci-trans-git},
    year = {2025},
    publisher = {GitHub},
    version = {0.2.0-alpha},
    url = {https://github.com/DobbiKov/sci-trans-git},
    doi = {10.5281/zenodo.15775111}
}

Contributing

The suggestions and pull requests are welcome. Visit the issues pages as well as the project's main page and the shared document in order to know the current direction and plans of the project.