Kismet

A dice roll parser with personality

Installation

pip install kismet

Jupyter

After installation with pip, you may optionally install the Jupyter kernel:

pythom -m kismet.kernel.install

Docker

Command Line Interface

docker run autochthe/kismet

Jupyterlab Server

docker run -p 8888:8888 autochthe/kismet.jupyter

With vim

docker run -p 8888:8888 autochthe/kismet.jupyter.vim

Chatbots

Discord

Define DISCORD_CLIENTID and DISCORD_TOKEN.

DISCORD_CLIENTID=00000 \
DISCORD_TOKEN=xxx.xxx \
docker run \
    -e DISCORD_CLIENTID \
    -e DISCORD_TOKEN \
    autochthe/kismet.discord

Slack

Define SLACK_TOKEN.

SLACK_TOKEN=xxx-xxx-xxx \
docker run \
    -e SLACK_TOKEN \
    autochthe/kismet.slack

Docker service runners

These scripts manage and run Docker services (eg. on cloud hosting).

WARNING: These runners automatically call docker image prune.

Jupyterlab Server

wget https://raw.githubusercontent.com/autochthe/kismet-py/master/docker/run/kismet.jupyter
chmod a+x kismet.jupyter
./kismet.jupyter

With vim

wget https://raw.githubusercontent.com/autochthe/kismet-py/master/docker/run/kismet.jupyter.vim
chmod a+x kismet.jupyter.vim
./kismet.jupyter.vim

Discord Bot

wget https://raw.githubusercontent.com/autochthe/kismet-py/master/docker/run/kismet.discord
chmod a+x kismet.discord

Create a .env file with DISCORD_CLIENTID and DISCORD_TOKEN:

DISCORD_CLIENTID=00000
DISCORD_TOKEN=xxx.xxx

./kismet.discord

The OAuth invite link will print to stdout.

Discord Permissions

Permissions integer: 377957238848

• Send Messages
• Send Messages in Threads
• Create Public Threads
• Create Private Threads
• Embed Links
• Attach Files
• Read Message History
• Add Reactions

Slack Bot

wget https://raw.githubusercontent.com/autochthe/kismet-py/master/docker/run/kismet.slack
chmod a+x kismet.slack

Create a .env file with SLACK_TOKEN:

SLACK_TOKEN=xxx-xxx-xxx

./kismet.slack

Slack Bot

Define SLACK_TOKEN before execution.

wget https://raw.githubusercontent.com/autochthe/kismet-py/master/docker/run/kismet.slack
chmod a+x kismet.slack

## Edit `kismet.slack` and
# ./kismet.slack

## OR
# SLACK_TOKEN=xxx.xxx \
# ./kismet.slack