OpenParable
Skip to content
← Back to skills

Django Run Locally

Development
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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/fossasia/eventyay/blob/HEAD/.agents/skills/django-run-locally/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/django-run-locally, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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:
    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.