Integration Guides
PolePosition keeps external-system scaffolds opt-in. A new project starts lean, then you add integration helpers only when the application needs them.
Current integration surfaces. Each adds settings, an env entry, a dependency, and a test double unless noted:
| Integration | What it scaffolds | Guide | Example |
|---|---|---|---|
| Kafka | Event-streaming producer and consumer helper | Kafka | Quick Start |
| RabbitMQ | AMQP publisher, consumer helper, queue factory | RabbitMQ | Quick Start |
| Redis | Async cache helper | Redis | Redis Cache |
| RQ | Redis-backed background job queue helpers, worker factory | RQ | — |
| LLM | Provider-agnostic adapter stubs (generated by an ai-prompt module) | LLM | OpenAI Prompt |
Integration scaffolds are starting points. They do not start background consumer loops inside the FastAPI application process. Keep long-running workers explicit in your deployment or runtime code.
For end-to-end examples, see:
After adding an integration, run:
polepos check
uv sync --extra dev