Project ELYSSA

Welcome to ELYSSA, an innovative tool developed as part of ERC TARICA's research on political and socio-institutional changes in the Maghreb.

This ERC Proof of Concept project is a platform for exploring, visualizing, and analyzing electoral data in Tunisia and the Maghreb post-2011. Leveraging a comprehensive electoral database built over the past 5 years, ELYSSA is designed to facilitate access to election-related information, aiding various users such as NGOs, media, political actors, and cooperation institutions.

This tool contributes to the democratization of electoral information, strengthening civil society's understanding of political processes in the region. The project, funded as a recognition of the valuable work undertaken in ERC TARICA, will support the updating of existing data, the collection of new data for upcoming Tunisian elections, identification of user needs, and the ongoing development of the technical tool. Explore ELYSSA and empower your insights into Maghreb's electoral landscape.

Projects in this Repository

1. JavaScript Version

A web-based platform built with JavaScript to explore, visualize, and analyze electoral data in the Maghreb region.

2. Python Version

A data exploration tool built with Python and Streamlit to facilitate in-depth analysis of electoral data.

Getting Started

JavaScript Version

To run the JavaScript version locally, follow these simple steps:

1. Ensure you have Node.js installed on your machine.
2. Clone this repository to your local environment.
3. Navigate to the javascript directory using your terminal.
4. Run the following commands:

Install dependencies

npm install

Start the development server

npm run dev

Visit http://localhost:3000 in your web browser to explore ELYSSA and empower your insights into Maghreb's electoral landscape.

Streamlit Version

To run the Streamlit version locally, follow these simple steps:

1. Ensure you have Python installed on your machine.
2. Clone this repository to your local environment.
3. Navigate to the streamlit directory using your terminal.
4. Run the following commands:

Install dependencies

pip install -r requirements.txt

Start the Streamlit app

streamlit run app.py

Visit http://localhost:8501 in your web browser to explore and analyze the data.

Features

• Explore electoral data through an intuitive and user-friendly interface.
• Visualize and analyze trends in voting and political changes post-2011.
• Contribute to the democratization of electoral information and strengthen civil society's understanding of political processes in the region.

Feel free to contribute, report issues, or provide feedback. Happy exploring!