Release v5.0.0

v5.0.0 (2026-09-15)

Upgrade instructions

As of Aspects V5 the default data pipeline has changed from Ralph to Vector. This change improves performance and simplifies the architecture by eliminating the need to scale multiple Ralph containers and Celery workers for high-throughput scenarios.

Key changes:

Vector is now the default for xAPI event ingestion
The ASPECTS_VECTOR_RAW_XAPI_TABLE setting has been replaced with ASPECTS_RAW_XAPI_TABLE
The default database has changed from xapi (Ralph) to openedx (Vector)
To keep using Ralph as your data pipeline:

tutor config save --set ASPECTS_XAPI_SOURCE=ralph
tutor config save --set RUN_RALPH=True
tutor config save --set RUN_VECTOR=False
This will configure Aspects to use Ralph with the xapi database, preserving your existing data.

If you have customized ASPECTS_VECTOR_RAW_XAPI_TABLE in your configuration, update it to use ASPECTS_RAW_XAPI_TABLE instead.

For new installations or users switching to Vector, your data will be stored in the openedx database. You can migrate existing data from the xapi database to openedx if needed.

Bug Fixes

• Add new permission (#1305, 481e221)

• Bump xapi-do-load for bug fix (971bfd0)

• Change command name to xapi_block_storage_backfill consistently (f8065ec)

• Change to decimals (#1309, 7e2f1bf)

• Cleanup from rebase (2d39163)

• Correct Superset dockerfile patch name (48d8d1b)

• Custom dark theme for superset 6.1 (#1309, 7e2f1bf)

• Fix clickhouse report url (ac94216)

• Lint issues caused by style fix (34b83b6)

• Set xapi_database on EVENT_SINK_CLICKHOUSE_BACKEND_CONFIG (da6445e)

• Update default load test config to support vector (09a63ef)

• Update default load test config to support vector (3c03d49)

• Upgrade to newer xapi-db-load (f472982)

• Use DBT_PROFILE_TARGET_DATABASE schema in 4 hardcoded datasets (#1316, 465ec30)

• V6 fields and fixing uuids (#1309, 7e2f1bf)

Build System

• Cache images and migrations (777d111)

• Fix integration tests (a7635df)

• Update tests to also test the Vector configurations (1ee69ed)

Chores

• Add breaking change (911fa13)

• Disable batching by default (886096f)

• Format files (5f85497)

• Remove duplicated integration tests (ecf20bd)

• Restore defaults for load test (dd8c736)

• Update yaml for superset 6 format (#1304, fd1fc16)

• Updating yaml files to match superset v6 export (#1304, fd1fc16)

• Updating yaml files to match superset v6 export (#1303, 36412bd)

• Upgrade dbt to v7.0.0 (a26c8fd)

• Upgrade Python requirements (#1314, e91cb05)

• Upgrade Python requirements (#1311, 4f73fb6)

• Upgrade Python requirements (#1306, e9bfddd)

• Upgrade Python requirements (#1302, 94fa8ae)

• Upgrade xapi-db-load to v3.1.0 (a229613)

• deps: Bump docker/setup-buildx-action from 4.2.0 to 4.3.0 (#1307, 6247c14)

• deps: Bump helm/kind-action from 1.14.0 to 1.15.0 (#1315, e57f39d)

• deps: Bump python-semantic-release/python-semantic-release (917b1c4)

Code Style

• Fix formatting (094abed)

• Fix line length error (f37c421)

• Fix style issues (bef9fe7)

• Fix style issues caused by lint issue fix caused by style fix (7cfb70a)

Documentation

• Fix doc formatting (d6ff0de)

• Update note about images in plugin.py (c01cf13)

Features

• Add s3 vector sink (465b1dd)

• Add s3 xapi backfill (2dbdad3)

• Add vector aggregator (c37c6bb)

• Added new patch to customize superset image (30e29dd)

• Change default dark theme colors to work with white text (#1309, 7e2f1bf)

• Install frontend-app-aspects from the alpha track (592b5d4)

• Set vector as default data pipeline (86addda)

• Upgrade Vector to 0.50.0, fix migrations (dd93845)

• Upgrading to superset 6.1 (#1305, 481e221)

Refactoring

• Add new config for Alembic database, simplify CH grants (0b29222)

• Add new config for Alembic database, simplify CH grants (f7b792c)

---

Detailed Changes: v4.0.0...v5.0.0