This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

This is a Jupyter kernel that deploys a chatbot, implemented using the pyAIML library. The idea was taken from the Calysto chatbot kernel.

It has been tested with Python 2.7 and Jupyter 4.1. It will not work with Python 3.

Installation

The installation process requires two steps:

  1. Install the Python package:

    pip install aimlbotkernel
    
  2. Install the kernel into Jupyter:

    jupyter aimlbotkernel install [--user]
    

The --user option will install the kernel in the current user’s personal config, while the generic command will install it as a global kernel (but needs write permissions in the system directories).

Note that the Jupyter kernel installation also installs some custom CSS; its purpose is to improve the layout of the kernel results as they are presented in the notebook (but it also means that the rendered notebook will look slightly different in a Jupyter deployment in which the kernel has not been installed, or within an online viewer).

To uninstall, perform the inverse operations (in reverse order), to uninstall the kernel from Jupyter and to remove the Python package:

jupyter aimlbotkernel remove
pip uninstall aimlbotkernel

Operation

Once installed, an AIML Chatbot kernel will be available in the Notebook New menu. Starting one such kernel will create a chatbot. The chatbot is initially empty but can be loaded with a couple of predefined DBs (use the %help magic for initial instructions).

Notebook input is of two kinds:

  • Regular text cells are considered human input and are sent to the chatbot, which produces its corresponding output
  • Cells starting with % contain “magic” commands that affect the operation of the kernel (load AIML databases, inspecting/modifying bot state, saving/loading state to/from disk, etc). Use the %help magic for some instructions, and %lsmagics to show the current list of defined magics (magics have autocompletion and contextual help).

The examples directory contains a few notebooks showing some of the provided functionality.

AIML

AIML is an XML-based specification to design conversational agents. Its most famous application is ALICE, a chatbot (the DB for the free version of ALICE is included in this kernel, as it is part of pyAIML)

The chatbot can load an AIML database (which is basically a bunch of XML files). It can also define AIML rules on the fly, by using the %aiml magic in a cell.

Release History

Release History

1.0.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
aimlbotkernel-1.0.2.tar.gz (26.5 kB) Copy SHA256 Checksum SHA256 Source Aug 11, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting