Skip to main content

Chatsky is a free and open-source software stack for creating chatbots, released under the terms of Apache License 2.0.

Project description

Chatsky

Documentation Status Codestyle Tests License Apache 2.0 Python 3.8, 3.9, 3.10, 3.11 PyPI Downloads

Chatsky allows you to develop conversational services. Chatsky offers a specialized domain-specific language (DSL) for quickly writing dialogs in pure Python. The service is created by defining a special dialog graph that determines the behavior of the dialog agent. The latter is then leveraged in the Chatsky pipeline. You can use the framework in various services such as social networks, call centers, websites, personal assistants, etc.

Chatsky, a versatile Python-based conversational service framework, can be deployed across a spectrum of platforms, ensuring flexibility for both novice and seasoned developers:

  • Cloud platforms like AWS, Azure, and GCP offer scalable environments for Chatsky, with options such as AWS Lambda and Azure Functions providing serverless execution.
  • For containerized deployment, Docker and Kubernetes streamline the orchestration of Chatsky applications.
  • Furthermore, the framework's adaptability extends to IoT ecosystems, making it suitable for integration with edge devices in scenarios like smart homes or industrial automation.

Whether deployed on cloud platforms, containerized environments, or directly on IoT devices, Chatsky's accessibility and customization options make it a robust choice for developing conversational services in the evolving landscape of Python applications and IoT connectivity.

Why choose Chatsky

  • Written in pure Python, the framework is easily accessible for both beginners and experienced developers.
  • For the same reason, all the abstractions used in Chatsky can be easily customized and extended using regular language synthax.
  • Chatsky offers easy and straightforward tools for state management which is as easy as setting values of a Python dictionary.
  • The framework is being actively maintained and thoroughly tested. The team is open to suggestions and quickly reacts to bug reports.

Quick Start

System Requirements

  • Supported operating systems include Ubuntu 18.04+, Windows 10+ (partial support), and MacOS Big Sur (partial support);
  • Python version 3.8 or higher is necessary for proper functionality;
  • A minimum of 1 GB of RAM is required for optimal performance;
  • If analytics collection or database integration is intended, Docker version 20 or higher may be necessary.

Installation

Chatsky can be installed via pip:

pip install chatsky

The above command will set the minimum dependencies to start working with Chatsky. The installation process allows the user to choose from different packages based on their dependencies, which are:

pip install chatsky[json]  # dependencies for using JSON
pip install chatsky[pickle] # dependencies for using Pickle
pip install chatsky[redis]  # dependencies for using Redis
pip install chatsky[mongodb]  # dependencies for using MongoDB
pip install chatsky[mysql]  # dependencies for using MySQL
pip install chatsky[postgresql]  # dependencies for using PostgreSQL
pip install chatsky[sqlite]  # dependencies for using SQLite
pip install chatsky[ydb]  # dependencies for using Yandex Database
pip install chatsky[telegram]  # dependencies for using Telegram
pip install chatsky[benchmark]  # dependencies for benchmarking

For example, if you are going to use one of the database backends, you can specify the corresponding requirements yourself. Multiple dependencies can be installed at once, e.g.

pip install chatsky[postgresql,mysql]

Basic example

The following code snippet builds a simplistic chat bot that replies with messages Hi! and OK depending on user input, which only takes a few lines of code. All the abstractions used in this example are thoroughly explained in the dedicated user guide.

from chatsky import (
    GLOBAL,
    TRANSITIONS,
    RESPONSE,
    Pipeline,
    conditions as cnd,
    Transition as Tr,
)

# create a dialog script
script = {
    GLOBAL: {
        TRANSITIONS: [
            Tr(
                dst=("flow", "node_hi"),
                cnd=cnd.ExactMatch("Hi"),
            ),
            Tr(
                dst=("flow", "node_ok")
            )
        ]
    },
    "flow": {
        "node_hi": {RESPONSE: "Hi!"},
        "node_ok": {RESPONSE: "OK"},
    },
}

# initialize Pipeline (needed to run the script)
pipeline = Pipeline(script, start_label=("flow", "node_hi"))


pipeline.run()

When you run this code, you get similar output:

request: hi
response: text='OK'
request: Hi
response: text='Hi!'

More advanced examples are available as a part of documentation: tutorials.

Further steps

To further explore the API of the framework, you can make use of the detailed documentation. Broken down into several sections to highlight all the aspects of development with Chatsky, the documentation for the library is constantly available online.

Contributing to Chatsky

We are open to accepting pull requests and bug reports. Please refer to CONTRIBUTING.md.

License

Chatsky is distributed under the terms of the Apache License 2.0.

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

chatsky-0.9.0.tar.gz (101.9 kB view details)

Uploaded Source

Built Distribution

chatsky-0.9.0-py3-none-any.whl (152.9 kB view details)

Uploaded Python 3

File details

Details for the file chatsky-0.9.0.tar.gz.

File metadata

  • Download URL: chatsky-0.9.0.tar.gz
  • Upload date:
  • Size: 101.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.10.12 Linux/6.8.0-1014-azure

File hashes

Hashes for chatsky-0.9.0.tar.gz
Algorithm Hash digest
SHA256 4aa1a4e43c56212d6f776a12c8a099ffbfd749101d25154d0a67c0df7a175fd9
MD5 b5232067baaf9c3325018fe9947953d4
BLAKE2b-256 85edb87ef5cb1a42fa1e756d2e52e5e64f64031fd035188c761c5af5ddea8d84

See more details on using hashes here.

File details

Details for the file chatsky-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: chatsky-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 152.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.10.12 Linux/6.8.0-1014-azure

File hashes

Hashes for chatsky-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7e368b7ae30fe9d8564e3edd108cb252311a7aa6d7d278fe3b587ef5ace3a79d
MD5 199560139702ff10e19cc7d5938ba0f5
BLAKE2b-256 c31f1548631904aae958355cebb42c9936079e59e4932e03325b517141c93987

See more details on using hashes here.

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