Prerequisites
- Python 3.x
- pip
- virtualenv or the
venvmodule (included with Python 3.3+)
Create and activate a virtual environment
Create a virtual environment in the project root:Then activate it:
- macOS / Linux
- Windows (PowerShell)
- Windows (Command Prompt)
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.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:Apply database migrations
SIGEP uses SQLite by default (
db.sqlite3). Run migrations to create the database schema:Create a superuser
Create an administrator account to access the Django admin panel and SIGEP’s admin area:Follow the prompts to set a username, email address, and password.
Run the development server
Start the built-in development server:Static files are served from
static/ and uploaded media files are served from media/ automatically during development.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.