The current version of Coquery is 0.10.0. This version is fully functional, and is sufficiently stable for regular use.

There are a few bugs, problems, and unexpected behaviors, though. For a list of known bugs, see the Issue tracker on the Coquery GitHub site. If you encounter a bug that is not listed in the Issue tracker, please do not hesitate to create a new issue so that it can be fixed in a future Coquery release.


The Windows installer will install everything on your computer that is needed to run Coquery. After installing, start Coquery from the Windows application menu.

Windows installer: coquery-0.10.0-setup-win32.exe Download

Mac OS X

For Mac OS X, the Coquery application is bundled in a disk image. After downloading and opening the disk image, move the Coquery application to a folder on your computer, e.g. the Applications folder.

Mac OS X disk image: coquery-0.10.0-macos-sierra.dmg Download

If the disk image does not work on your version of Mac OS X, you can follow the installation instructions given below for Linux on your computer.


The easiest way of installing Coquery on a Linux computer is as a Python package. This option is also available to Windows and Mac OS X users.

In order to install Coquery as a Python package, follow these steps:

  • Download and install the free Anaconda Python distribution from

  • Open a terminal, and execute the following command:

    pip install coquery

    This command will download and install the Coquery program, as well as any additional Python module that is required to run Coquery. A network connection is needed during the install.

Coquery can now be started by typing coquery at the command line.


Most Linux and Mac OS X systems already provide a Python installation by default. Do not install Anaconda if you do not want to change this Python interpreter.

However, using Anaconda (or a similar distribution) is strongly recommended. Most of the additional Python packages required by Coquery are already included in this distribution. On most default Python installations, many of these packages need to be installed together with Coquery, and some of them (most notably, the packages NumPy and PySide) can occassionally be rather difficult to install on default Python installations.

Optional Python modules

If you have installed Coquery as a Python package, you may will have to install the following optional Python packages to enable all features in Coquery.

  • PyMySQL 0.6.4 or later – A pure-Python MySQL client library (Connect to MySQL database servers)
  • Seaborn 0.7 or later – A Python statistical data visualization library (Create visualizations of your query results)
  • SciPy 0.13.0 or later – Open-source software for mathematics, science, and engineering (Use more accurate statisticsal tests)
  • TextGridTools 1.3.1 or later – Read, write, and manipulate Praat TextGrid files (save results from time-annotated corpora as Praat TextGrids)

The following command installs these modules:

pip install pymysql scipy seaborn tgt

Additionally, the following modules may be installed if you want to create new corpora from your own collection of files:

  • NLTK 3.2.1 or later – The Natural Language Toolkit (provides automatic lemmatization and part-of-speech tagging, English only)
  • PDFMiner – Support for PDF documents (for Python 2.7)
  • pdfminer3k 1.3 or later – Support for PDF documents (for Python 3.x)
  • python-docx 0.3.0 or later – Support for Microsoft Word (.docx) files
  • odfpy 1.2.0 or later – Support for OpenDocument files (e.g. Open Office, Libre Office)
  • BeautifulSoup 4.0 or later – Support for HTML documents
  • chardet 2.0.0 or later – Automatical detection of character encodings in your text files

The following command installs these modules using pip (for Python 2.7):

pip install nltk pdfminer python-docx odfpy bs4 chardet

The following command installs these modules using pip (for Python 3.x):

pip install nltk pdfminer3k python-docx odfpy bs4 chardet