Skip to content

Setting up development environment

  • Clone the howdoi repository:
$ git clone
  • To see how to set up the development for Windows, see here.

  • Set up and activate a virtual environment:

$ python3 -m venv .venv
$ source .venv/bin/activate
  • Install all the required packages:
$ pip install -r requirements/dev.txt
  • Running from command line :
$ python -m howdoi QUERY
  • From a Python script, you can call howdoi with howdoi.howdoi and pass your query in the argument.
from howdoi import howdoi
query = "for loop python"
output = howdoi.howdoi(query)

Or, parse it yourself and then pass the arguments:

from howdoi import howdoi
query = "for loop python"
parser = howdoi.get_parser()
args = vars(parser.parse_args(query.split(' ')))
output = howdoi.howdoi(args)


  • Parsing queries yourself is the older way to pass in queries and may be deprecated in the future. Please use the first example.
  • If you try running python howdoi/ (without -m) you might get ValueError: Attempted relative import in non-package.