How to handle Slack slash commands with FastAPI using Slackers?

Slackers sets up a /commands endpoint that emits events based on command names. Use the @commands.on() decorator to listen for specific commands, like @commands.on('engage') for /engage, and access the payload for custom logic.

Slackers vs slack-bolt: which is better for Python Slack apps?

Slackers is lightweight and FastAPI-specific, ideal for simple webhook handling with event-driven architecture. Slack-bolt is more feature-rich with official Slack support, including OAuth and socket mode, but heavier. Choose Slackers for FastAPI integration; slack-bolt for comprehensive features.

Can I use async functions with Slackers event handlers?

Yes, Slackers supports async event handlers using pyee's Async event emitter. However, errors in async handlers must be caught via a separate @commands.on('error') or similar event listener, as shown in the async example.

How to set up custom HTTP responses for Slack actions in Slackers?

Use the @responder decorator to define custom response handlers that return Starlette responses, like JSONResponse. Ensure only one responder per request, and note that events are emitted asynchronously without awaiting the response.

Does Slackers automatically handle the Slack Events API challenge?

Yes, Slackers detects and automatically responds to the challenge request when setting up event subscriptions, so no manual code is needed for verification, as mentioned in the events section.

What endpoints does Slackers set up for Slack interactions?

Slackers provides endpoints at /events for the Events API, /actions for interactive components, and /commands for slash commands. These can be prefixed using FastAPI routing, as shown in the server setup example.

Open-Awesome

Slackers

MITPython

A FastAPI-based server to handle Slack webhooks, slash commands, interactive components, and events.

GitHub

163 stars11 forks0 contributors

What is Slackers?

Slackers is a FastAPI-based framework for building Slack apps that handles Slack interactions and events. It provides endpoints for slash commands, app actions, interactive components, and the Slack Events API, simplifying webhook reception and emitting Python events for custom handling.

Target Audience

Python developers building Slack integrations or bots using FastAPI, who need to handle Slack's webhooks and events without boilerplate code.

Value Proposition

Developers choose Slackers for its lightweight, event-driven architecture built on FastAPI's efficiency, allowing them to focus on custom logic rather than managing webhook infrastructure. It offers async support and custom responders for flexible response handling.

Overview

Slack webhooks API served by FastAPI

Use Cases

Best For

Building Slack bots that respond to slash commands with custom logic.
Creating Slack apps that handle interactive components like buttons and dropdowns.
Implementing Slack event subscriptions for app mentions or custom events.
Developing FastAPI-based backends for Slack integrations with async support.
Overriding default Slack webhook responses with custom HTTP replies.
Setting up Slack webhook endpoints quickly with minimal configuration.

Not Ideal For

Projects requiring active maintenance and frequent feature updates, given the project is in low maintenance mode.
Teams not using FastAPI or preferring comprehensive Slack SDKs like slack-bolt with built-in OAuth and real-time support.
Applications needing extensive error handling and middleware beyond basic event emission, as async errors require manual listening.

Pros & Cons

Pros

FastAPI Integration

Seamlessly integrates with FastAPI routers, allowing easy inclusion in existing FastAPI applications with minimal setup, as shown in the installation and configuration examples.

Event-Driven Architecture

Uses decorator-based event listeners for slash commands, actions, and events, simplifying custom logic implementation without boilerplate code, as demonstrated in the usage snippets.

Async Support

Supports asynchronous event handlers via pyee's Async event emitter, enabling non-blocking operations for better performance, with examples for async command handling.

Custom Response Flexibility

Allows overriding default HTTP 200 responses with custom handlers using the responder decorator, providing control over Slack interactions, as detailed in the custom responders section.

Cons

Low Maintenance Status

The project is explicitly in low maintenance mode with no active feature development, risking compatibility issues with future Slack API changes and limited bug fixes.

Limited Feature Set

Focuses only on basic webhook handling for slash commands, actions, and events, lacking built-in support for advanced Slack features like OAuth flows, real-time socket mode, or message posting.

Async Error Handling Overhead

Async event handlers require separate error event listeners for proper error management, adding complexity compared to synchronous frameworks with integrated error handling.

Frequently Asked Questions

Related Projects

Polar

Turn your software into a business.

All of the ad-hoc things you're doing to manage incidents today, done for you, and much more!

Stars6,464

Forks664

Last commit9 months ago

TermPair

View and control terminals from your browser with end-to-end encryption 🔒

Stars1,735

Forks74

Last commit2 months ago

Awesome FastAPI Projects

List of FastAPI projects! :sunglasses: :rocket:

Stars1,603

Forks142

Last commit6 days 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