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.

Filename, size & hash SHA256 hash help File type Python version Upload date
kutana-0.0.2-py3-none-any.whl (5.7 kB) Copy SHA256 hash SHA256 Wheel py3
kutana-0.0.2.tar.gz (8.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page