zuijiaoluo / linda

:princess: Multi-platform, highly configurable conference bot.

Linda

Multi-platform, highly configurable conference bot.

Example usage:

Navigation:

1. Features
2. Limitations
3. Configuration
4. Installation
5. Docker

Features

• Different adapters support:
  • Slack
  • Telegram^beta
• Configurable commands:
  • bully - reacts with predefined phrase to matched text.
  • copycat - returns same text, can be powerful in combination with filters.
  • help - prints information about instantiated commands.
  • postman - grabs latest unread item from RSS/Atom feed.
  • proxy - fetches JSON document from URL, returns computed template.
• Built-in filters:
  • base64 - encodes input text to base64.
  • md5 - calculates md5 sum of input text.
  • translit - transliterates input text.
  • uppercase - converts input text to uppercase.
• User-friendly:
  • Configurable greeting and farewell messages.
  • Configurable reaction to user status change.
  • Has option to get configuration file by provided URL.
  • shy mode in case of being annoyed by large amount of greetings.

Limitations

Because of the fact that different chat services have different protocols and available options, some usage limitations are present. The table of differences lies below:

Feature	Slack	Telegram
All types of commands	✅ Supported	✅ Supported
Specific channel to listen	✅ Supported	❌ (Currently Linda responds to everyone)
Greetings & farewells	✅ Supported	❌ (Possible, but not yet implemented)
Status change reactions	✅ Supported	❌ (Possible, but not yet implemented)

Configuration

• See linda.example.toml for configuration example.

Installation

Install glide tool.

Build and run:

$ go get github.com/kpashka/linda
$ export LINDA_CONFIG=<path_or_url_to_your_configuration_file>
$ linda -c $LINDA_CONFIG

Docker

Use the automated build from Docker Registry.

$ make pull
$ LINDA_CONFIG=<url_to_your_configuration_file> make up