Skip to content

RSS Digest Summarizer

Beginner
ai rss slack productivity automation

Poll any RSS/Atom feed for new articles, summarize each with AI, and post a curated digest to a Slack channel automatically.

RSS Digest Summarizer is an automation that polls any RSS or Atom feed for new articles, uses OpenAI to summarise each item, and delivers a clean digest report to a Slack channel on a configurable schedule.

What it does

  • RSS monitoring: Polls any RSS/Atom feed for new articles with rss-digest (every 3 minutes by default)
  • AI summarisation: Passes each article through OpenAI (gpt-4o-mini) for a concise summary via summarize-content
  • Slack delivery: Formats all summaries into a rich Slack message and posts it to a channel via send-digest

Environment variables (.env / keyring on apps)

VariablePurpose
HABITS_OPENAI_API_KEYOpenAI API key for content summarisation
HABITS_SLACK_BOT_TOKENSlack Bot User OAuth Token (xoxb-...)
HABITS_SLACK_DIGEST_CHANNELSlack channel ID to post the digest to
HABITS_RSS_FEED_URLRSS/Atom feed URL to monitor for new articles

How to set up

  1. Copy .env.example to .env and fill in your credentials.
  2. Set any RSS/Atom feed URL in HABITS_RSS_FEED_URL.
  3. Create a Slack app, add chat:write and channels:read bot scopes, install it to your workspace, and copy the xoxb- token.
  4. Invite the bot to your target channel and copy the Channel ID into HABITS_SLACK_DIGEST_CHANNEL.
  5. Click Start Automation in the UI — articles will be discovered, summarized, and posted to Slack every 3 minutes.

Tech stack

  • habits framework for workflow orchestration
  • OpenAI (@ha-bits/bit-openai) for natural-language article summarisation
  • RSS (@ha-bits/bit-rss) for feed polling
  • Slack (@ha-bits/bit-slack) for digest delivery

Run Your .habit File

Run on Mobile

  • [ ] Download the Cortex App from store or the downloads page
  • [ ] Open the Cortex App on your device
  • [ ] Tap "Open Habit" or "+" button
  • [ ] Select your .habit file from your device storage
  • [ ] The habit will be loaded and ready to run

Run on Desktop

  • [ ] Download the Cortex App for your platform from the downloads page
  • [ ] Install and open the Cortex App
  • [ ] Click "Open Habit" or drag & drop your .habit file
  • [ ] The habit will be loaded and ready to run
  • [ ] Optional: Place a .env file in the same directory as your .habit file to override environment variables

Run on Server

Run your .habit file as a server using the Cortex CLI:

bash
# Install and run in one command
npx @ha-bits/cortex --config ./your-app.habit
  • [ ] Make sure Node.js 20+ is installed
  • [ ] Run the command above with your .habit file path
  • [ ] Server will start on the specified port (default: 3000)
  • [ ] Access the app at http://localhost:3000
  • [ ] Optional: Place a .env file next to your .habit file - it will automatically override any embedded environment variables

Run Serverless

For serverless or containerized deployments, we recommend using Docker:

bash
# Using Docker (recommended for serverless)
docker run -p 3000:3000 -v $(pwd)/your-app.habit:/app/habit.habit \
  node:20-alpine npx @ha-bits/cortex --config /app/habit.habit --host 0.0.0.0

Or create a Dockerfile:

dockerfile
FROM node:20-alpine
WORKDIR /app
COPY your-app.habit ./
COPY .env ./ # Optional: include environment variables
RUN npm install -g @ha-bits/cortex
EXPOSE 3000
CMD ["cortex", "--config", "./your-app.habit", "--host", "0.0.0.0"]
  • [ ] Create a Dockerfile or use the Docker run command above
  • [ ] Deploy to your preferred cloud provider (AWS, GCP, Azure, etc.)
  • [ ] Configure environment variables via your cloud provider's secrets management
  • [ ] Set up health checks at /habits/base/api endpoint

Workflow Visualization

Requirements

  • OPENAI_API_KEY (OpenAI API key)
  • SLACK_BOT_TOKEN (Slack Bot User OAuth Token)
  • SLACK_DIGEST_CHANNEL (Slack channel ID to post the digest to)
  • RSS_FEED_URL (RSS/Atom feed URL to monitor for new articles)

Quick Start

Run using the Habits CLI wrapper, recommended if you develop local Habits

# First, download the example files
npx habits@latest cortex --config ./rss-digest-summarizer/stack.yaml

Get in touch

Want this habit running in your environment?

This habit is a starting point. Tell us about your stack and we'll help you get it working exactly the way your team needs.

Released under the AGPL-3.0 License.