Minha Região is an open-source platform that consolidates electoral information from 1976 to 2021 for each of the 3,091 Portuguese parishes.
The project won the 2025 edition of the Arquivo.pt award.
This repository serves as an index of the technology stack supporting the Minha Região project.
Fig.1: Minha Região Software Architecture
- Minha Região Web – Repository hosting the PHP/Laravel code for the web application.
- Minha Região Package – Repository hosting the Python code for the data science and machine learning operations that support the Minha Região ecosystem.
The codebase that enabled the winning submission to the 2025 Arquivo.pt award is strategically kept in a private repository. Continuous integration ensures that only code which is well-tested and adheres to sound software engineering practices is made public.
If a specific piece of code would be embarrassing to show to one of my students, it will not be released publicly until it has been properly revised.
Currently private components include:
- Web crawlers
- Database seeders
- NLP strategies for structuring crawled data
We welcome your contributions! This platform was built as a side project, driven solely by the desire to democratize access to electoral data across districts, cities, and parishes.
If you believe regions play a key role in Portugal’s future development, feel free to reach out.
Check our GitHub Projects for a list of features and suggestions for further improvements:
- Frontend / Backend Developers: Web Project
- Data Scientists: Data Science Project
The original team behind the 2025 Arquivo.pt submission was led by Rúben Almeida, under the supervision of Ricardo Campos and Sérgio Nunes.
Minha Região is a non-profit platform. Hosting and maintenance are funded by the author, Rúben Almeida.