tschellenbach

Stream-Framework: Build Python Newsfeeds with Cassandra and Redis

Stream-Framework is a Python library for building activity streams, newsfeeds, and notification systems on Cassandra and/or Redis. It uses Celery for asynchronous feed updates and supports feed fanout to users' followers.

Stars
4.7k
Forks
527
Stars, last 30 days
-3
Last commit
11 months ago
Contributors
22

Our take

Quietno commits in the last 90 days and no release in a year

Health score

30/100

How it is scored
Activity
19
Community
60
Issues
21
Pull requests
20

-3 stars in the last 30 days

This is a focused Python feed framework with useful fanout abstractions, but its quiet maintenance status and unclear license make adoption a decision that needs careful review.

Good fit if

  • You are building a Python activity-feed or newsfeed feature and want Redis or Cassandra-backed storage with Celery-based asynchronous fanout.
  • Your team can evaluate and maintain the framework and its infrastructure; the repository is not archived, but has had no recent commits or releases.
  • You are considering the authors' hosted Stream service instead of operating feed infrastructure yourself.

Look elsewhere if

  • You need a project with recent releases or visible recent issue and pull-request activity. The health data reports no recent commits, releases, issue closures, or merged pull requests.
  • You cannot resolve licensing before adoption. GitHub reports no asserted license, and the repository input provides no license terms.
  • You need a feed service without operating Redis or Cassandra and Celery workers, and do not want to use the hosted service.
All health signals
Last commit2025-12-04 (11 months ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors22 (top contributor: 49% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age14 years

Checked on 2026-11-03 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

4,740

Forks

528

Change since Nov 17, 2026: 0 stars·+1 forks

Overview

Stream-Framework is a Python library built on Cassandra and/or Redis for creating activity streams, newsfeeds, and notification systems. It addresses the challenge of distributing feed updates to many users while keeping feed reads lightweight, using Celery to run feed fanout work asynchronously.

It is aimed at Python developers building social or content-driven products, including Twitter-style feeds, activity timelines, and notifications. The README also points to Stream, the authors' hosted feed service, for teams that prefer a REST API over running the storage and worker infrastructure themselves.

Key Features

  • Stores feeds using Redis, Cassandra, or both.
  • Models feed entries as activities and supports adding them to user feeds.
  • Provides manager classes to fan out activities to followers' feeds.
  • Uses Celery tasks to handle feed distribution asynchronously.
  • Offers reusable feed components that can be adapted to different use cases.
  • Includes optional installation extras for Redis and Cassandra dependencies.

Use Cases

  • A Python social app can publish a user's post to their own activity feed and their followers' feeds.
  • A photo-sharing or bookmarking service can create Pinterest- or Instagram-style feeds from user activity.
  • A product with GitHub-style activity timelines can assemble events from followed users.
  • A service that needs notification feeds can use the framework's activity and feed model, provided it is prepared to operate the supporting data stores and workers.

What you need

Detected in the repository

  • Python (from setup.py)

Getting Started

Install the package with pip:

pip install stream-framework

For Redis or Cassandra support, install the corresponding optional dependencies, such as pip install 'stream-framework[redis]'. See the README and documentation for configuration and usage details.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Considerations

The project is marked quiet: there have been no commits in the last 90 days and no release in over a year. The health data also reports no issue closures or merged pull requests in that period. It has 22 contributors, and contributor activity is not flagged as concentrated around one person, but the recent maintenance signals still warrant checking compatibility and support needs before adopting it.

The library requires Python and relies on Redis and/or Cassandra for feed storage, with Celery used for asynchronous work. The README describes Cassandra support in the context of Cassandra 2.1 and says 2.2 and 3.3 pass its test suite, while noting a lack of production experience with those versions. GitHub reports no asserted license, so confirm the applicable licensing terms before using or redistributing the code.

Found this useful?

Share it with someone who would like Stream-Framework.