README.md

Myson: Pythonic Bot to send notifications to Telegram

Myson is Telegram bot, to helps teams to get notifications and execute various shell commands. Following are few usecases for which Myson was built:

1. Get notification of different events from a remote server
2. Allow execution of various shell commands from Telegram application

Features

1. Notify: Send notification on a myson bot
2. Photo: Send a linked photo to user or group
3. Document: Send a document to user or group
4. Group Management: Create telegram groups or add member to existing group
5. Linux Shell: Access linux server from telegram personal chat window (Interactive commands are not implemented for example top command)

Installation

1. Clone the repository

git clone git@bitbucket.org:fafadiatech/myson.git

2. Create virtualenv

mkvirtualenv myson
workon myson

3. Install required dependencies and start the server

• Create telegram bot, {You want to check #6 specifically}
• Create telegram app id
• Update settings.py

  cd myson
  pip install -r requirements.txt
  python api.py
  python bot.py

Dependencies

Myson uses following libraries

• Telegram python bot - Pythonic interface to Telegram Bot API
• Telethon - Telethon is Telegram client implementation in Python 3
• Flask - Flask is a microframework for Python
• Paramiko - Paramiko is a Python implementation of the SSHv2 protocol

Development

Verify the deployment by navigating to your server address in your preferred browser.

127.0.0.1:5000

TODOs

• Create frontend
• Implement ssh session storage