# Django Run Locally

> Django Run Locally is an Agent Skill for development published in the fossasia/eventyay repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Steps for initiating the Django development server without Docker

- Skill name: `django-run-locally`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/fossasia/eventyay/blob/HEAD/.agents/skills/django-run-locally/SKILL.md
- Repository: fossasia/eventyay (1,641 GitHub stars when collected)

## SKILL.md

## When to use

Use this skill to spin up or invoke the local development backend sequence for rapid testing processes.

## Steps

1. Navigate securely into the active architecture directory: `cd app`
2. Synchronously install or update environment dependencies strictly through `uv`: `uv sync --all-extras --all-groups`
3. Activate the standard CLI venv wrapper: `. .venv/bin/activate`
4. Deploy local DB schema synchronization calls: `python manage.py migrate`
5. *(Optional)* Setup initial admin: `python manage.py create_admin_user`
6. Build Frontend Assets:
   ```bash
   make npminstall
   python manage.py collectstatic --noinput
   python manage.py compress --force
   ```
7. Initialize the development environment natively: `python manage.py runserver`

## Validation

1. Verify server startup output bindings properly format against standard generic ports (ex. `127.0.0.1:8000`).
2. There should be **no pending/unapplied migration warnings** displayed.
3. Verify `http://127.0.0.1:8000` loads properly without missing CSS/MIME type errors.

## Gotchas

- **Strict Environment Imports**: If context dynamically requires variable settings locally, ALWAYS safely fetch these utilizing `from django.conf import settings`. Never import the isolated system settings configuration natively (e.g. absolutely never execute `from eventyay.config import settings`).
- **CSS not loading / MIME type errors**: Ensure you have successfully run `collectstatic` and `compress --force` steps to properly build the Javascript/CSS chunks.

---

Source: https://www.openparable.com/skill/development/django-run-locally (OpenParable). Cite the canonical URL above.
