Skip to main content

Asyncio API wrapper for the Travitia Cleverbot API. (https://public-api.travitia.xyz/talk)

Project description

CircleCI Build Status Codestyle PyPI version Issues LICENSE Downloads Python

async_cleverbot

Asyncio API wrapper for the Travitia Cleverbot API. (https://public-api.travitia.xyz/talk)

Installation

Installing with pip from PyPI

pip install -U async_cleverbot

Installing with pip + git from GitHub

pip install -U git+https://github.com/crrapi/async-cleverbot

Usage

import async_cleverbot as ac

cleverbot = ac.Cleverbot("Your API key here") # Create the Cleverbot client
response = await cleverbot.ask("How are you today?") # Ask a question, returns async_cleverbot.cleverbot.Response
print(response.text) # Text from the Response object
await cleverbot.close()

Getting an API key

Join the Travitia API Discord server and use the > api command to request an API key. Getting a key

Using context

This API supports a context parameter for background context, so let's make use of it!

import async_cleverbot as ac

cleverbot = ac.Cleverbot("Your API key here", ac.DictContext())

response = await cleverbot.ask("How are you today?", 246938839720001536) # 2nd param is an identifier, this can be a user id!
print(response.text)

response = await cleverbot.ask("I'm doing good too.", 246938839720001536)
print(response.text)
print(cleverbot.context._storage) # "How are you today?" - returns most recent previous queries
await cleverbot.close()

New in 0.2.1: Emotions

This wrapper's API now supports selecting an emotion to influence its response.
You can specify a custom emotion using the enum async_cleverbot.Emotion.
(The default emotion is Emotion.neutral)

Supported emotions:

async_cleverbot.Emotion.neutral/normal - Neutral response
async_cleverbot.Emotion.sad/sadness - Sad response
async_cleverbot.Emotion.fear/scared - Fearful response
async_cleverbot.Emotion.joy/happy - Excited response
async_cleverbot.Emotion.anger/angry - Angry response

An example

import async_cleverbot as ac

cleverbot = ac.Cleverbot("Your API key here")
resp = await cleverbot.ask("What's up?", emotion=ac.Emotion.joy)
print(resp.text)

New in 0.2.2: Custom sessions, simpler context

You can now pass context and your own session when creating a cleverbot client.

import async_cleverbot as ac

cleverbot = ac.Cleverbot("Your API key here", session=my_aiohttp_sess, context=ac.DictContext())

In addition, DictContext no longer needs an argument.

The argument has been preserved for backwards compatability.

Project details


Download files

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

Files for async-cleverbot, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size async_cleverbot-0.2.2.tar.gz (4.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page