Skip to main content
Prerequisites
  • Python 3.x
  • pip
  • virtualenv or the venv module (included with Python 3.3+)
1

Clone the repository

Clone the SIGEP repository to your local machine:
git clone <repository-url>
cd SIGEP
2

Create and activate a virtual environment

Create a virtual environment in the project root:
python -m venv venv
Then activate it:
source venv/bin/activate
On Windows, the project includes a helper script activar_venv.bat in the repository root. Double-click it or run it from the terminal to activate the virtual environment automatically.
3

Install dependencies

The project’s virtual environment (venv/) contains all required packages including Django 6.0.2, Pillow, ReportLab, openpyxl, qrcode, and pyhanko. Install the core dependencies into your own environment:
pip install django==6.0.2 pillow reportlab openpyxl qrcode pyhanko requests
If you are running the included venv/ directly (Windows only — the venv is bundled for Windows), activate it with activar_venv.bat instead of creating a new one. On macOS or Linux, create a fresh virtual environment and install the packages listed above.
4

Apply database migrations

SIGEP uses SQLite by default (db.sqlite3). Run migrations to create the database schema:
python manage.py migrate
5

Create a superuser

Create an administrator account to access the Django admin panel and SIGEP’s admin area:
python manage.py createsuperuser
Follow the prompts to set a username, email address, and password.
6

Run the development server

Start the built-in development server:
python manage.py runserver
Static files are served from static/ and uploaded media files are served from media/ automatically during development.
7

Open SIGEP in your browser

Navigate to http://127.0.0.1:8000/ to verify the application is running.The Django admin panel is available at http://127.0.0.1:8000/admin/.

Next steps

Configuration

Learn which settings to update for your environment.

Production deployment

Deploy SIGEP to a production server.

Build docs developers (and LLMs) love