Skip to main content

Handles natural language inputs and outputs on cognitive robots

Project description


  1. LAAS-CNRS 2010-2013, EPFL 2013-2015

This module, licensed under the permissive BSD 3-clause, reads on stdin user input in natural language, parse it, call resolution routines when ambiguous concepts are used, and finally generate RDF statements that are an interpretation of the input.

It includes as well a verbalization module that conversely turns RDF statements into a sentence in natural language.

![Overview of the Dialogs pipeline](doc/dialogs_module_simple_small.png)

While not strictly required, it is strongly recommanded to use dialogs with a knowledge base that follows the ‘’KB API’’ like [minimalKB]( or [oro-server](

You are welcome to reuse this software for your research. Please refer to the CITATION file for proper attribution in scientific works.


Simply run:

` > pip install dialogs `

You can also grab the source code of the latest release [here](


You can start to use dialogs immediately. For instance, try:

` > dialogs -d -p"What are you doing?" > dialogs -d -p"I'm playing with you" `

The -d flags activates the debug mode, and gives you a complete picture of the different steps: pre-processing, parsing, semantic resolution of the atoms of the sentence, interpretation and verbalization ([read the paper]( to know more about these steps).

Lines displayed in cyan log the interactions of the dialogue module with the knowledge base (queries and knowledge revisions). If no knowledge base is running, most of the semantic resolution attempts will fail, so when asked “what are you doing?”, the system answers “I don’t know”.

If you start dialogs with no options, it will simply read on stdin.

Check dialogs --help for other options.

Common invokation is:

` > dialogs -d NAME_OF_THE_SPEAKER `

The main test-suite can be started with:

` > dialogs_test `


A live demo of the parser alone (not the semantic grounding part) is [available online](

Project details

Download files

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

Source Distribution

Dialogs-1.0.tar.gz (439.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page