---
id: django-activity-stream
version: "2.0.0"
license: BSD 3-Clause
license_treatment: permissive
maintenance: aging
---

# django-activity-stream — Generate generic activity streams from the actions on your site. Users can follow any actors' activities for personalized streams.

License: permissive · Maintenance: aging · Downloads: 151.0K/mo

## What it is and what it does

Django Activity Stream is a Django app that captures and displays streams of user-generated actions on your site. It models activities using four components—an Actor (who did it), a Verb (what they did), an Action Object (optional, what was affected), and a Target (optional, what it was done to)—allowing you to record events and display them as feeds.

The package is designed to support following and unfollowing of activity sources, enabling use cases like dashboards where users see actions from projects they watch and people they follow. Activities are stored in the database and can be queried and filtered to build personalized feeds. It integrates with Django's ORM and uses GenericForeignKeys to link activities to any model in your project.

Use it for:

- Build a dashboard showing actions from followed projects and users.
- Display a user's personal activity feed of their own actions on the platform.
- Track and display moderation events for site administrators.
- Create notification systems that alert users to actions by followed accounts.
- Log audit trails of important user actions for compliance or debugging.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Django Activity Stream generates and displays activity feeds from user actions on your site, allowing users to follow actors and see personalized streams of events.

Yes, if you need a straightforward activity stream for a Django project and can accept aging maintenance. The package is stable and permissively licensed, but the last release was 2023-10-04 and there are no recent commits. Verify compatibility with your Django version before installing, and consider whether you need active maintenance or community support.

## Install

pip install django-activity-stream
uv add django-activity-stream
poetry add django-activity-stream

## Installing django-activity-stream

Before you install: Low install friction with a single Django dependency. Maintenance status is aging—last release was 2023-10-04 and the repository shows no recent commits, though it remains archived-free with 2439 stars.

License in practice: BSD 3-Clause permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart:

pip install django-activity-stream

import django_activity_stream
# Configure in Django settings and use to record and query activities

Requires Django to be installed and configured in your project.

Verify before relying:

- Whether the package works with modern Django versions (latest release is from 2023-10-04).
- Current test coverage and compatibility with Python 3.9+.
- Performance characteristics with large activity streams.
- Specific API and usage patterns for recording and querying activities.

## Package facts

- License: BSD 3-Clause (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 151.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django activity feed, user action stream, activity log django, follow actor activities, event stream django, personalized activity feed, django action tracking, django-extension, activity-tracking, social-features

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