Install & Compatibility
Where this runs
tested against v2.0.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 66.8MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 3.4s · import 0.000s · 67MB
66MB installed
● package 66MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
action
✓ from actstream import action
✗ from actstream.models import Action
signals
✓ from actstream import signals
django
✓ from actstream import django
Basic usage: record actions and retrieve them. Requires setting up actstream app and running migrations.
from actstream import action
from actstream.models import Action, Follow
# Record an action
actor = request.user # assuming request.user exists
action.send(actor, verb='logged in')
# Get actions for a user
actions = Action.objects.filter(actor_object_id=actor.pk)[:10]
Debug
Known issues
breakingUpgrading from 0.x to 1.x+ requires running new migrations due to schema changes (e.g., Action.data field removal).fixRun `python manage.py migrate actstream` and ensure data field is handled.
affects: <1.0.0 to >=1.0.0
deprecatedThe `actstream_unfollow_all` URL name was changed in 0.6.2; old usage may break.fixUpdate URL references to use new pattern or check docs.
affects: <0.6.2
gotchaAction objects are immutable after creation (no save()). Editing them directly may cause issues.fixCreate new Action objects instead of modifying existing ones.
affects: all
Upgrade
Version history
2.0.0latest on PyPI · released Oct 4, 2023
Audit
Dependencies
DjangorequiredRequired; compatible with 4.1+ as of v2.0.0
djangorestframeworkoptionalOptional API serializers