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:

• Kafka: event streaming producer, consumer helper, settings, env, dependency, and test double.
• RabbitMQ: AMQP publisher, consumer helper, queue factory, settings, env, dependency, and test double.
• Redis: async cache helper, settings, env, dependency, and test double.
• RQ: Redis-backed background job queue helpers, worker factory, settings, env, dependency, and test double.
• LLM: provider-agnostic adapter stubs generated with an AI prompt module.

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:

• Kafka Quick Start
• RabbitMQ Quick Start
• Redis Cache
• OpenAI Prompt

After adding an integration, run:

polepos check
uv sync --extra dev