Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lucavallini/wert-app/llms.txt

Use this file to discover all available pages before exploring further.

This guide gets Wert App running on your local machine as quickly as possible. You need Python 3, pip, and a running MySQL server before you begin. If you want a more detailed walkthrough — including OS-specific instructions and SQL setup — see the installation guide.
1

Clone the repository

Clone the Wert App repository from GitHub and enter the project directory.
git clone https://github.com/lucavallini/wert-app.git
cd wert-app
2

Install Python dependencies

Install the three required packages using pip.
pip install PyQt5 mysql-connector-python requests
All other imports (sys, mysql.connector, etc.) are part of the Python standard library or the packages above.
3

Set up the MySQL database

Create the registro_usuarios database in MySQL. The application connects to this database automatically and creates the usuarios and notas tables on first run.
CREATE DATABASE registro_usuarios;
The app connects as root on localhost:3306. Make sure your MySQL server is running before launching Wert App.
4

Create the passwordBDD.txt file

In the project root, create a plain-text file named passwordBDD.txt containing only your MySQL root password.
echo "your_mysql_password" > passwordBDD.txt
passwordBDD.txt must exist in the same directory as main.py. The app reads this file at startup via database/conexion.py. If the file is missing, the application will crash before the window opens.
5

Launch the application

Run main.py from the project root. The entry point calls setTables() to create the database schema, then opens the login window.
python main.py
You should see the Wert App login window appear. The database tables are created automatically if they do not already exist.
6

Register an account and log in

Click Register on the login screen to create a new account. Passwords must be at least six characters. After registering, return to the login screen, enter your credentials, and click Log in to access the main window with all features enabled.

​
What runs at startup

For reference, here is the complete main.py entry point:
main.py
import sys
from modules.logica_login import ventanaLogin
from PyQt5.QtWidgets import QApplication
from database.db_operations import DatabaseManager
from database.conexion import setTables, getConexion

def main():
    if __name__ == '__main__':
        setTables()
        app = QApplication(sys.argv)
        ventana_log = ventanaLogin()
        ventana_log.show()
        sys.exit(app.exec_())

main()
setTables() runs CREATE TABLE IF NOT EXISTS for both usuarios and notas, so it is safe to call on every startup.

​
Next steps

Installation guide

Detailed setup with OS-specific instructions and all configuration options.

Introduction

Overview of all features and the technology stack.

Build docs developers (and LLMs) love

Get started for freeTalk to us