How do I deploy an Alice bot to Heroku?

Follow the README steps: create a Heroku app with an Elixir buildpack, set SLACK_API_TOKEN and other env vars, configure a Procfile as a worker, and scale the worker process. It requires manual setup but is well-documented.

Alice vs Lita: which is better for Slack bots?

Choose Alice if you prefer Elixir for concurrency and functional programming; Lita is Ruby-based and might have a larger ecosystem. Alice is inspired by Lita but leverages Elixir's strengths for scalable bots.

Can I use Alice with Discord instead of Slack?

No, Alice is specifically designed for Slack integration via its Web API and real-time messaging. For Discord, you'd need to fork the project or use a different framework like discord.py or discord.js.

How to create a custom handler in Alice?

Create a new module using Alice.Router, define commands with regex patterns like command ~r/pattern/, and implement callback functions. The README includes a full example with the Google Images handler.

Is Alice production-ready?

Yes, with version 0.4.2 and coverage status, it's stable for production use. However, being in 0.x means there might be breaking changes in future updates, so monitor releases closely.

What are the best handlers to start with for Alice?

Start with community handlers like Alice Google Images for image searches or Alice Karma for tracking points. Check the known handlers list in the README for options like games and reddit integration.

Open-Awesome

alice

NOASSERTIONElixirv0.4.3

A Lita-inspired Slack bot framework for Elixir, featuring a plugin system for custom handlers.

Visit Website GitHub

113 stars19 forks0 contributors

What is alice?

Alice is an open-source Slack bot framework written in Elixir, inspired by Lita. It enables developers to build custom Slack bots with a plugin-based architecture for handling commands and messages. The framework simplifies integration with Slack's API and supports extensibility through reusable handlers.

Target Audience

Elixir developers and teams looking to create custom, interactive Slack bots for automation, notifications, or fun interactions within their workspace.

Value Proposition

Developers choose Alice for its Elixir-native design, which offers concurrency benefits and a clean syntax, along with a flexible plugin system that makes it easy to extend functionality without modifying core code.

Overview

A Slack bot framework for Elixir; down the rabbit hole!

Use Cases

Best For

Building custom Slack bots for team automation
Creating interactive Slack games or fun commands
Integrating third-party APIs into Slack via bot commands
Developing extensible bots with reusable handler plugins
Learning Elixir through practical chat application projects
Deploying lightweight, self-hosted Slack bots to platforms like Heroku

Not Ideal For

Teams not using Elixir or unfamiliar with its ecosystem
Projects requiring bot support for multiple chat platforms like Discord or Microsoft Teams
Developers seeking out-of-the-box bots with extensive pre-built commands and minimal coding
Applications needing advanced AI or natural language processing features without custom integration

Pros & Cons

Pros

Modular Plugin System

Enables easy creation and integration of custom handlers through a structured route system, as detailed in the handler writing guide with regex-based command matching.

Elixir Concurrency Benefits

Leverages Elixir's actor model for efficient, concurrent message handling, making it suitable for high-traffic Slack bots without performance bottlenecks.

Comprehensive Testing Support

Includes Alice.HandlerCase for unit testing handlers with simulated message flows, ensuring reliability and easier debugging, as shown in the testing examples.

Straightforward Deployment

Provides clear, step-by-step instructions for deploying to Heroku with environment variable configuration, simplifying production setup for common platforms.

Cons

Dependency Management Hurdle

Requires handling non-Hex dependencies like websocket_client manually, complicating initial setup and updates compared to fully Hex-managed packages.

Slack-Exclusive Design

Lacks abstractions for other chat platforms, making it unsuitable for projects targeting multiple services without significant core modifications.

Minimal Core Functionality

The framework is lean, so complex features require building or finding handlers, which may be limited in the growing but small ecosystem.

Open Source Alternative To

alice is an open-source alternative to the following products:

Lita

Frequently Asked Questions

Related Projects

cog

Bringing the power of the command line to chat

Stars919

Forks69

Last commit4 years ago

hedwig

An Adapter-based Bot Framework for Elixir Applications

Stars648

Forks68

Last commit3 years ago

ExGram

Telegram Bot API low level API and framework

Stars236

Forks33

Last commit1 month ago

ExIrc

IRC client adapter for Elixir projects

Stars154

Forks38

Last commit2 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub