stream-python

What it is and what it does

stream-python is the official Python SDK for Stream Feeds, a hosted service for building scalable newsfeeds and activity streams. It provides a client library to interact with Stream's API from your Python backend, handling feed creation, activity management (add, remove, retrieve), follow relationships, and user token generation for client-side integrations. The library supports both synchronous and asynchronous workflows via aiohttp, making it suitable for blocking or event-driven architectures.

The package depends on requests, pyjwt, pytz, and aiohttp to handle HTTP communication, JWT token generation, timezone operations, and async I/O. It's designed for server-side use; client-side integrations (web, iOS, Android) use separate SDKs. The library has been in active development since 2014 and is classified as production-stable.

Use it for:

• Build a social media feed backend where users follow other users and see their activities aggregated in real time.
• Implement an activity log or notification feed that tracks user actions (likes, comments, follows) and distributes them to relevant feeds.
• Create a multi-feed system (e.g., user feed, flat feed, notification feed) with follow relationships and batch operations.
• Generate secure client-side tokens for JavaScript or mobile clients to read feeds without exposing backend API secrets.
• Perform bulk activity ingestion and feed management operations using batch endpoints for high-throughput scenarios.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Official Python client library for Stream Feeds API, enabling server-side management of newsfeeds and activity streams with support for both synchronous and asynchronous operations.

Yes. The package is actively maintained, production-stable, has low install friction, carries no known vulnerabilities, and uses a permissive license. Install it if you are building a backend that needs to manage newsfeeds or activity streams via Stream's hosted service. If you are building client-side feed UI (web or mobile), use the appropriate client SDK instead.

Install

stream-python on PyPI

pip install stream-python

uv add stream-python

poetry add stream-python

Installing stream-python

Before you install

Low install friction with a pure-wheel distribution. Actively maintained with recent commits and a stable production-grade status; supports modern Python versions from 3.7 onward.

License in practice

BSD-3-Clause is permissive; you may use, modify, and distribute this library freely in commercial and private projects with minimal restrictions.

Quickstart

pip install stream-python

import stream
client = stream.connect('YOUR_API_KEY', 'API_KEY_SECRET')
user_feed = client.feed('user', '1')
activity_data = {'actor': 1, 'verb': 'tweet', 'object': 1}
response = user_feed.add_activity(activity_data)

Requires valid Stream API credentials (API key and secret) from getstream.io dashboard to connect and make requests.

Verify before relying

• Whether the library handles rate limiting or connection pooling automatically for high-volume feed operations.
• Performance characteristics when managing large numbers of followers or activities in a single feed.
• Whether async mode requires additional setup beyond passing use_async=True to stream.connect().

Package facts

Evidence: stream_python-5.4.0-py3-none-any.whl

Tags

More Software Development packages