---
id: stream-python
version: "5.4.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# stream-python — Client for getstream.io. Build scalable newsfeeds & activity streams in a few hours instead of weeks.

License: permissive · Maintenance: active · Downloads: 908.0K/mo

## 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 above — 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

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

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 908.0K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

activity stream sdk python, newsfeed api client, stream feeds python, activity feed management, social feed backend, async feed client, activity stream service, activity-streams, async-support, feed-management

[View on SkillFed](https://skillfed.io/packages/stream-python) · [View on PyPI](https://pypi.org/project/stream-python/)