Skip to content

pusparajm/linda

Repository files navigation

Linda

Build Status GoDoc

Multi-platform, highly configurable conference bot.

Example usage:

Navigation:

  1. Features
  2. Limitations
  3. Installation
  4. Configuration
  5. Deployment
    1. Docker
    2. Heroku
  6. Credits

Features

  • Different adapters support:
  • 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)

Installation

Install godep tool.

Build and run:

$ go get https://github.com/kpashka/linda
$ cd $GOPATH/src/github.com/kpashka/linda
$ godep restore
$ go build && ./linda -c <path_to_your_configuration_file>

Configuration

Deployment

Docker

Use the automated build from Docker Registry.

$ docker pull kpashka/linda
$ docker run -e "LINDA_CONFIG=<url_of_your_configuration_file>" kpashka/linda

Heroku

Heroku

Credits

About

Multi-platform, highly configurable conference bot.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages