Skip to content

Starter templates for DriftQ: copy/paste production patterns for durable, replayable workflows.

License

Notifications You must be signed in to change notification settings

driftq-org/DriftQ-Starters

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

DriftQ-Starters 🚀

Starter templates for DriftQ — copy/paste production patterns for durable, replayable workflows.

These are intentionally small repos you can use as a baseline when you’re building real systems that need:

  • retries + backoff
  • DLQ (dead-letter queue)
  • replay
  • safe side effects (idempotency)
  • versioned indexes + rollback (RAG)

Templates

1) driftq-starter-fastapi-nextjs — “DLQ → Replay → Success” in ~2 minutes

FastAPI API + Next.js UI + worker, wired to DriftQ-Core (Docker Compose).

This is the “show it, don’t explain it” demo:

  • force a failure
  • watch retries
  • DLQ payload persists
  • replay with a fix applied → success âś…
  • UI streams the run timeline live via SSE

Repo: https://github.com/driftq-org/driftq-starter-fastapi-nextjs Best for: quick demos, onboarding, proving the DLQ/replay story


2) driftq-side-effects-starter — idempotency + safe retries (no duplicate side effects)

A more production-ish starter that proves a real claim:

Retries won’t duplicate side effects — even if the worker crashes mid-step and DriftQ redelivers the message.

It shows a clean pattern:

  • DriftQ for durable commands + redelivery
  • idempotent worker
  • exactly-once markers stored in SQLite (effect_id)
  • simple proof artifacts you can eyeball

Repo: https://github.com/driftq-org/driftq-side-effects-starter Best for: payments/webhooks/tickets/LLM tool calls where double-execution is unacceptable


3) driftq-rag-index-demo — versioned RAG index build + replay + rollback (Qdrant)

A small, production-minded demo that shows how to:

  • use DriftQ-Core (via Docker) as a task queue + redelivery engine
  • build and version a tiny Qdrant RAG index
  • replay failed runs safely
  • roll back an index by switching a Qdrant alias

Runs locally inside Docker (no local Python or jq needed).

Repo: https://github.com/driftq-org/driftq-rag-index-demo Best for: RAG ingestion/index builds, versioning + alias-based rollback, replayable pipelines

DriftQ-Core

These starters are just templates. The engine lives here:

https://github.com/driftq-org/DriftQ-Core

About

Starter templates for DriftQ: copy/paste production patterns for durable, replayable workflows.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published