Build and deploy Django apps with confidence.
tawala is the core framework package that provides:
- Django settings and app wiring for Tawala projects
- A project runtime command (
tawala) with Django management subcommands - Additional commands such as
runserver,runinstall, andrunbuild
- Python 3.14+
- A valid Tawala project configuration in
pyproject.tomlunder[tool.tawala]
With uv:
uv add tawalaWith pip:
pip install tawalaScaffold a new project with the CLI:
uvx tawala-cli new --project my-new-project
cd my-new-project
uv sync
uv run tawala migrate
uv run tawala runserverShow all available commands:
tawala --helpRun development server:
tawala runserverRun configured install/build pipelines:
tawala runinstall --dry
tawala runbuild --dryPostgreSQL support:
uv add "tawala[psycopg]"Vercel tooling support:
uv add "tawala[vercel]"