Skip to main content

High-speed conversational dialogue engine

Project description

Flipgenic: High-speed conversational dialogue engine


What is it?

Flipgenic is a library for creating simple chatbots. A Flipgenic bot starts with an empty mind and learns how to communicate over time by reusing messages it has seen in previous conversations. It does not write anything original.

Here is an example from its use in Axyn:

Screenshot of example conversation

Flipgenic is focused on fast reply times and a simple API. Chatterbot, a more well-known library, has additional features such as custom filters and logic adapters.

How do I use it?

Here is a basic example:

# python -m pip install flipgenic
# python -m spacy download en_core_web_md

from flipgenic import Responder

# Create and connect to database
# This can take a while to load the spaCy models
responder = Responder('/path/to/data/folder/')

# Initialize the database with a single response
responder.learn_response('Hello', 'Hi!')

response = None
while True:
    text = input('> ')

    if response:
        # Learn the input as a response to the previous output
        responder.learn_response(response, text)

    # Generate a response
    response, distance = responder.get_response(text)
    print(response, f'({distance})')

For more, see ReadTheDocs.

How does it work?

  1. Upon calling get_response, the input is converted to a 300-dimensional vector. The vector embeddings for each word are provided by SpaCy; calculating the mean gives a single vector representing the whole text.
  2. A closest match is found by searching the vectors of previously seen messages. An NGT index improves performance.
  3. The search result corresponds to one or more known responses. These responses are stored in an SQLite database.
  4. The most common response is chosen, or if there is no mode, we select a response from the list at random.
  5. Along with the selected response, the distance between the input vector and the search result is returned as a confidence heuristic.

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

flipgenic-0.6.0.tar.gz (17.2 kB view hashes)

Uploaded Source

Built Distribution

flipgenic-0.6.0-py3-none-any.whl (18.1 kB view hashes)

Uploaded Python 3

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