pavel-karpovich / artem

Bot engine for vk.com

Artem

This project is no longer being developed, but it still works fine.

Simple core for creating chatbots in VK (vk.com)

Artem is an easy core for creating chatbots in vk.com based on the flexible mechanism of user scenarios for replies.

Installing artem

To install artem through pip, execute follow command:

pip install artem

Also you can download the package from Python Package Index or Github Releases, unzip archive and use this command for install:

python setup.py install

Start of use

The simplest example of launching:

import artem

art = artem.Artem(GROUP_ID, GROUP_ACCESS_KEY)
art.on('MESSAGE', handler='Hello World from Artem!')
art.alive()

After running this script, the bot-chat will answer any incoming message with the words "Hello World from Artem!". For more, see below.

Description of the artem core

Artem core

The simplified scheme of the Artem core functioning:

Artem events

Artem has three groups of handled scenarios:

1. Scenarios of incoming events:
   • JOIN
   • MESSAGE
2. Scenarios of time events:
   • TIME
   • IDLE
   • SILENCE
3. Scenarios for postprocessing events:
   • POSTPROC
4. Startup scenario:
   • START

Full event Handling Schema:

artem's Issues

Potential dependency conflicts between artem and urllib3

Hi, as shown in the following full dependency graph of artem, artem requires urllib3 * ， while the installed version of requests(2.22.0) requires urllib3 <1.26,>=1.21.1.

According to Pip's “first found wins” installation strategy, urllib3 1.25.7 is the actually installed version.

Although the first found package version urllib3 1.25.7 just satisfies the later dependency constraint （urllib3 <1.26,>=1.21.1), it will lead to a build failure once developers release a newer version of urllib3.

Dependency tree--------

artem - 3.0.1
| +- apiai(install version:1.2.3 version range:*)
| | +- numpy(install version:1.17.4 version range:*)
| +- certifi(install version:2019.9.11 version range:*)
| +- chardet(install version:3.0.4 version range:*)
| +- idna(install version:2.8 version range:*)
| +- metadate(install version:0.5.74 version range:*)
| | +- enum-compat(install version:0.0.3 version range:*)
| | | +- enum34(install version:1.1.6 version range:*)
| | +- python-dateutil(install version:2.8.1 version range:*)
| +- numpy(install version:1.17.4 version range:*)
| +- protobuf(install version:3.11.0 version range:*)
| +- requests(install version:2.22.0 version range:*)
| | +- certifi(install version:2019.9.11 version range:>=2017.4.17)
| | +- chardet(install version:3.0.4 version range:<3.1.0,>=3.0.2)
| | +- idna(install version:2.8 version range:>=2.5,<2.9)
| | +- urllib3(install version:1.25.6 version range:<1.26,>=1.21.1)
| +- setuptools(install version:42.0.1 version range:*)
| +- six(install version:1.13.0 version range:*)
| +- sortedcontainers(install version:2.1.0 version range:*)
| +- urllib3(install version:1.25.6 version range:*)
| +- vk-api(install version:11.6.1 version range:*)
| | +- enum34(install version:1.1.6 version range:*)
| | +- requests(install version:2.22.0 version range:*)
| | | +- certifi(install version:2019.9.11 version range:>=2017.4.17)
| | | +- chardet(install version:3.0.4 version range:<3.1.0,>=3.0.2)
| | | +- idna(install version:2.8 version range:>=2.5,<2.9)
| | | +- urllib3(install version:1.25.6 version range:<1.26,>=1.21.1)
| | +- six(install version:1.13.0 version range:*) 

Thanks for your attention.
Best,
Neolith