Skip to content

docs: add ScyllaDB (Alternator) storage provider#727

Open
zseta wants to merge 1 commit into
agno-agi:mainfrom
zseta:docs/add-scylladb-storage
Open

docs: add ScyllaDB (Alternator) storage provider#727
zseta wants to merge 1 commit into
agno-agi:mainfrom
zseta:docs/add-scylladb-storage

Conversation

@zseta

@zseta zseta commented Jul 15, 2026

Copy link
Copy Markdown

Description

ScyllaDB exposes a DynamoDB-compatible API (Alternator), so Agno's existing DynamoDb
class works against it by pointing a boto3 client at the Alternator endpoint.

Every page mentions the mandatory Alternator write-isolation that's needed so
concurrent counter and conditional writes aren't silently dropped
(--alternator-write-isolation=always or only_rmw_uses_lwt).

Type of Change

  • New content (docs for a new provider)

Related Issues/PRs

Closes agno-agi/agno#8965
Related PR: agno-agi/agno#8964 (ScyllaDB storage cookbook)

Checklist

  • Content is accurate and verified against a working integration
  • Internal links tested — mint broken-links clean
  • Code examples verified (storage layer 13/13 against a live Alternator container)
  • Spelling/grammar reviewed
  • AI-assisted, human reviewed and validated

ScyllaDB exposes a DynamoDB-compatible API (Alternator), so Agno's existing
DynamoDb class works against it by pointing a boto3 client at the Alternator
endpoint. No agno code changes are required.

Add a ScyllaDB storage provider tree mirroring the DynamoDB pages:
- database/providers/scylladb: overview + agent/team/workflow usage
- examples/storage/scylladb and examples/agent-os/dbs/scylla
- reference/storage/scylladb and _snippets/db-scylladb-params
- register the pages in docs.json (nav + examples + reference)
- list ScyllaDB alongside DynamoDB in the provider index, storage feature
  table, and contents-db backend list

Every page carries the mandatory Alternator write-isolation warning
(--alternator-write-isolation=always or only_rmw_uses_lwt); permissive modes
silently drop concurrent counter/conditional writes. A disambiguation note
distinguishes this storage integration (Alternator) from the existing
ScyllaDB vector-store integration (Cassandra driver).

Verified with `mint broken-links` (clean).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Storage: Add ScyllaDB (Alternator) as a storage backend

1 participant