Skip to main content

The engine for developing bots for soc. networks, instant messengers and other systems.

Project description

Kutana logo

Documentation Status Build Status CodeFactor Codacy Badge Coverage Status Total alerts


The engine for developing bots for soc. networks, instant messengers and other systems.


  • Download and install python (3.5.2+)
  • Install python modules from requirements.txt using installed python (user python3 if needed)
python -m pip install -r requirements.txt
  • Put folder kutana into your python path or into your project (proper module in pypi will be available later).
- myproject/
-- kutana/
-- ...


  • Create Kutana engine and add controllers. You can use shortcuts like VKKutana for adding and registering controllers, callbacks and other usefull functions.
  • You can set settings in Kutana.settings.
  • Add or create plugins other files and register them in executor. You can import plugin from files with function load_plugins. Files should be a valid python modules with available plugin field with your plugin (Plugin).
  • Start engine.


from kutana import Kutana, VKKutana, load_plugins

# Creation
kutana = VKKutana(configuration="configuration.json")

# Settings
kutana.settings["MOTD_MESSAGE"] = "Greetings, traveler."

# Create simple plugin
plugin = Plugin()

@self.plugin.on_text("hi", "hi!")
async def greet(message, attachments, env, extenv):
    await env.reply("Hello!")


# Load plugins from folder

# Start kutana

Example plugins/

from kutana import Plugin

plugin = Plugin() = "Echo"

async def on_message(message, attachments, env, extenv):
    await env.reply("{}!".format(env.body))

Available controllers

  • VKController ( groups)


Task Priority
Find and fix all current bugs high
Find and fix grammar and semantic errors high
Create proper documentation medium
Adding tests medium
Add module to PyPi low
Developing plugins very low


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 kutana, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size kutana-0.0.2-py3-none-any.whl (5.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size kutana-0.0.2.tar.gz (8.5 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