Storage Adapters

Storage adapters provide an interface that allows ChatterBot to connect to different storage technologies.

The storage adapter that your bot uses can be specified by setting the storage_adapter parameter to the import path of the storage adapter you want to use.

chatbot = ChatBot(
    "My ChatterBot",
    storage_adapter="chatterbot.storage.SQLStorageAdapter"
)

Built-in Storage Adapters

• Redis Vector Storage Adapter
  • Redis Setup
  • Redis Configuration
  • Class Attributes
  • More on Vector Databases
• MongoDB Storage Adapter
  • MongoDB Adapter Class Attributes
• SQL Storage Adapter
  • SQLStorageAdapter
• Django Integration
  • Install packages
  • Django App Development
  • General Django Tutorials

Common storage adapter attributes

Each storage adapter inherits the following attributes and methods.

class chatterbot.storage.StorageAdapter(*args, **kwargs)

This is an abstract class that represents the interface that all storage adapters should implement.

exception AdapterMethodNotImplementedError

An exception to be raised when a storage adapter method has not been implemented. Typically this indicates that the method should be implement in a subclass.

exception EmptyDatabaseException(message=None)

count()

Return the number of entries in the database.

create(**kwargs)

Creates a new statement matching the keyword arguments specified. Returns the created statement.

create_many(statements)

Creates multiple statement entries.

drop()

Drop the database attached to a given adapter.

filter(**kwargs)

Returns a list of objects from the database. The kwargs parameter can contain any number of attributes. Only objects which contain all listed attributes and in which all values match for all listed attributes will be returned.

Parameters:

• page_size – The maximum number of records to load into memory at once when returning results. Defaults to 1000

• order_by – The field name that should be used to determine the order that results are returned in. Defaults to None

• tags – A list of tags. When specified, the results will only include statements that have a tag in the provided list. Defaults to [] (empty list)

• exclude_text – If the text of a statement is an exact match for the value of this parameter the statement will not be included in the result set. Defaults to None

• exclude_text_words – If the text of a statement contains a word from this list then the statement will not be included in the result set. Defaults to [] (empty list)

• persona_not_startswith – If the persona field of a statement starts with the value specified by this parameter, then the statement will not be returned in the result set. Defaults to None

• search_text_contains – If the search_text field of a statement contains a word that is in the string provided to this parameter, then the statement will be included in the result set. Defaults to None

• search_in_response_to – If the search_in_response_to field of a statement contains a word that is in the string provided to this parameter, then the statement will be included in the result set. Defaults to None

get_model(model_name)

Return the model class for a given model name.

model_name is case insensitive.

get_object(object_name)

Return the class for a given object name.

object_name is case insensitive.

get_random()

Returns a random statement from the database.

remove(statement_text)

Removes the statement that matches the input text. Removes any responses from statements where the response text matches the input text.

update(statement)

Modifies an entry in the database. Creates an entry if one does not exist.

Database Migrations

Various frameworks such as Django and SQL Alchemy support functionality that allows revisions to be made to databases programmatically. This makes it possible for updates and revisions to structures in the database to be be applied in consecutive version releases.

The following explains the included migration process for each of the databases that ChatterBot comes with support for.

• Django: Full schema migrations and data migrations will be included with each release.

• SQL Alchemy: No migrations are currently provided in releases. If you require migrations between versions Alembic is the recommended solution for generating them.

• MongoDB: No migrations are provided.

• Redis: No migrations are provided.

Further Reading

• Text Search
  • Text Search Example
  • Bigram Text Index
• Creating a new storage adapter

Ask a question under the chatterbot tag	Report an issue on GitHub
Subscribe to the ChatterBot Newsletter Email Address