Skip to main content

Project scaffolding tools for creating a new crowdsourcing or citizen science application with the wq framework.

Project description


wq.start provides a simple command-line interface (wq start) for starting a new project with the wq framework, with for the front end and wq.db as the backend component. wq.start also provides commands for generating a default set of offline-capable list, detail, and edit templates. The templates can be generated for existing Django models (via wq maketemplates), or both the models and the templates can be generated from an ODK-style XLSForm (via wq addform).

Latest PyPI Release Release Notes License GitHub Stars GitHub Forks GitHub Issues

Travis Build Status Python Support Django Support


# Recommended: create virtual environment
# python3 -m venv venv
# . venv/bin/activate
python3 -m pip install wq

wq start <projectname> [directory]
cd <projectname>/db
wq addform ~/my-odk-form.xlsx

See the Getting Started docs for more information.


  • wq start <projectname> [directory]: Create a new Django project (from the wq Django template)
  • wq addform ~/myodk-form.xlsx: Create a new Django app from the provided XLSForm (uses xlsform-converter)
  • wq maketemplates: Create templates for Django models registered with

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wq.start-1.2.1.tar.gz (75.6 kB view hashes)

Uploaded source

Built Distribution

wq.start-1.2.1-py3-none-any.whl (70.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page