Django Run Locally
Developmentdjango-run-locallyDjango 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
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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
- Navigate securely into the active architecture directory:
cd app - Synchronously install or update environment dependencies strictly through
uv:uv sync --all-extras --all-groups - Activate the standard CLI venv wrapper:
. .venv/bin/activate - Deploy local DB schema synchronization calls:
python manage.py migrate - (Optional) Setup initial admin:
python manage.py create_admin_user - Build Frontend Assets:
make npminstall python manage.py collectstatic --noinput python manage.py compress --force - Initialize the development environment natively:
python manage.py runserver
Validation
- Verify server startup output bindings properly format against standard generic ports (ex.
127.0.0.1:8000). - There should be no pending/unapplied migration warnings displayed.
- Verify
http://127.0.0.1:8000loads 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 executefrom eventyay.config import settings). - CSS not loading / MIME type errors: Ensure you have successfully run
collectstaticandcompress --forcesteps to properly build the Javascript/CSS chunks.