haskbot-core: Easily-extensible chatbot for Slack messaging service

[ library, mit, network ] [ Propose Tags ] [ Report a vulnerability ]

Haskbot melds together the Slack slash command and incoming API integrations to create an easily-extensible platform for adding your own custom slash commands with arbitrary responses to your team's Slack service.

Sure, Hubot exists, but when I desire custom chatbot functionality, I'd rather write nice, clean Haskell than clunky Javascript any day of the week.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.0.1.0, 0.0.1.1, 0.1
Dependencies aeson (>=0.6 && <0.7), base (>=4.6 && <4.7), bytestring (>=0.10 && <0.11), connection (>=0.2 && <0.3), containers (>=0.5 && <0.6), http-conduit (>=2.1 && <2.2), http-types (>=0.8 && <0.9), monads-tf (>=0.1 && <0.2), stm (>=2.4 && <2.5), text (>=0.11 && <0.12), wai (>=3.0 && <3.1), warp (>=3.0 && <3.1) [details]
License MIT
Copyright (c) 2014 Jonathan Childress
Author
Maintainer Jonathan Childress <jon@childr.es>
Category Network
Home page https://github.com/jonplussed/haskbot-core
Source repo head: git clone https://github.com/jonplussed/haskbot-core
Uploaded by jonplussed at 2014-08-04T23:06:44Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 2444 total (12 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 1 reports]

Readme for haskbot-core-0.1

[back to package description]

Haskbot

An easily-extensible, Haskell-based Slack chatbot

The purpose of this little bot is to provide:

  • a slew of mini-services for Bendyworks
  • a simple platform for Bendyworkers to learn Haskell
  • a playground for exciting Haskell web modules, such as WAI, Warp, and Aeson

This README only demonstrates how to setup a Haskell dev environment for creating Haskbot plugins. Further documentation can be found on Hackage.

New to Haskell?

I find enjoyment of Haskell is greatly increased by a thorough reading of the first few chapters of Learn You a Haskell.... Of course, I highly recommend the entire book when you've time.

If you're an in-house Bendyworker, I'm also available before/after hours or during growth time to help or answer any questions.

Installing the Haskell Platform and Haskbot

To run Haskbot locally, all you require is the latest Haskell platform. If your distro of choice isn't Debian, this means your package manager probably provides it for you.

  1. Run the following to install the platform:

    • On Ubuntu

      sudo apt-get update
      sudo apt-get install haskell-platform
      
    • On OSX (via Homebrew)

      brew update
      brew install haskell-platform
      
  2. Add Cabal's (the Haskell package manager) bin folder to your shell's $PATH. This is usually done by adding the following lines to ~/.profile or ~/.bash_profile (whichever you have/prefer).

    PATH="$HOME/.cabal/bin:$PATH"
    export PATH
    

    Make sure to re-source whatever file contains the new $PATH, like so:

    source ~/.profile
    
  3. Update the Haskell packages via:

    cabal update
    cabal install cabal-install
    cabal install haskbot-core
    

Creating Plugins

You're now ready to begin creating plugins for your very own Haskbot! Continue on to Hackage for a full Haskbot API description and examples.

Thanks

I wouldn't have had time to write this without the growth time supplied by Bendyworks. Hey, employers! This is what developers need to survive.

License

See LICENSE.txt