By the end of this guide you will have a fully working Acrylitec instance running on your local machine, backed by an automatically created SQLite database, with a superuser account ready to log in. No external services or environment variables are required —Documentation Index
Fetch the complete documentation index at: https://mintlify.com/YonAnn99/Acrylitec/llms.txt
Use this file to discover all available pages before exploring further.
settings.py detects the absence of a DATABASE_URL variable and falls back to SQLite automatically.
Prerequisites — make sure the following are installed before you begin:
- Python 3.10 or newer (
python --version) - pip (bundled with Python 3.10+)
- git (
git --version)
Clone the repository
Download the source code and move into the project directory:The repository root contains
manage.py, the core/ configuration package, and the gestion/ application.Create a virtual environment
Isolate project dependencies from your system Python by creating a virtual environment named Your terminal prompt should now be prefixed with
.venv:- macOS / Linux
- Windows
(.venv), confirming the environment is active.Install dependencies
Install all required packages from Key packages installed:
requirements.txt:| Package | Version | Purpose |
|---|---|---|
Django | 6.0.3 | Web framework |
gunicorn | 25.3.0 | WSGI server for production |
whitenoise | 6.12.0 | Static file serving |
reportlab | 4.4.10 | PDF quote/order generation |
dj-database-url | 3.1.2 | Database URL parsing (PostgreSQL in prod) |
psycopg / psycopg-binary | 3.3.3 | PostgreSQL adapter — psycopg v3 (unused locally, required for Railway) |
Pillow | 12.2.0 | Product photo handling |
Apply migrations
Create the SQLite database and build all tables defined in Because
gestion/models.py:DATABASE_URL is not set in your local environment, core/settings.py automatically selects the SQLite backend and writes the database file to db.sqlite3 at the project root. No database server installation is needed.Create a superuser (Administrator)
Create your first user account. This account will be a Django superuser, which grants full Administrator access — including the financial dashboard (Follow the interactive prompts to set a username, email address, and password. You can also grant Administrator access to non-superusers later by adding them to the
/dashboard/) and pricing configuration (/configuracion/):Administrador group in the Django admin panel at /admin/.Start the development server
Launch Django’s built-in development server:Open your browser and navigate to:You will be redirected to the login page (
/login/). Sign in with the superuser credentials you created in the previous step. Superusers and members of the Administrador group are redirected to /dashboard/; all other authenticated users are redirected to the lista_cotizaciones view.The development server is for local use only. Do not use it in production. See the Deploy to Railway guide for production setup with Gunicorn and PostgreSQL.
What’s Next
Explore the Dashboard
Learn how to read revenue KPIs, interpret weekly and monthly sales charts, and monitor active orders from the admin dashboard.
Create Your First Quote
Walk through building a cost-accurate quotation — selecting a client, product, material, piece dimensions, and laser time.
Process a POS Order
Learn how to build a multi-item cart order, record a deposit, set a delivery date, and update order status through to delivery.
Deploy to Railway
Configure environment variables, connect a PostgreSQL database, and go live on Railway with Gunicorn and WhiteNoise.