What happens to my Chainlit response if Monetzly is down?

The SDK falls back to yielding your original token stream, so the user still receives a complete Chainlit answer — just without ads for that request.

Do I need a manual fallback in Chainlit?

The SDK handles fallback automatically, but wrapping the loop in your usual error handling is still good practice.

How-to guide

How to Handle Ad-Injection Errors in Chainlit

This guide shows how to handle ad-injection errors in a Chainlit app, the goal being to make sure the user still gets a reply if the ad service fails. It builds on the Monetzly gRPC service (no Python SDK exists for this stack), so the approach is specific to how Chainlit produces and streams responses.

Overview

Monetization should never break your Chainlit app. The Monetzly SDK is built for this: if the ad service connection fails or errors mid-stream, it falls back to yielding your original, un-injected token stream, so the user still gets a complete answer.

You should still wrap the injection loop in your normal error handling so a failure degrades to a plain Chainlit response rather than a broken request.

Chainlit apps are usually built for chat UIs for LLM apps, agent demos, and RAG chat frontends, so handle ad-injection errors typically comes up while a user is mid-conversation, the moment where monetization has to be additive rather than disruptive.

How this works on Chainlit

Chainlit is Python. Drive the shipped tps_alter.proto gRPC service (or a Node sidecar) and stream injected tokens into a Chainlit Message via msg.stream_token(). Confirm the non-JS auth handshake before publishing.

Since Chainlit is a Python stack with no official SDK, this task runs through the shipped tps_alter.proto gRPC service (or a Node sidecar); the auth handshake for a direct client is still TODO_VERIFY.

Steps

Wrap the injection loop in your standard Chainlit error handling.
Rely on the SDK's automatic fallback to the original stream on ad-service failure.
Log injection failures so you can monitor fill and uptime separately from your model.

Integration snippet

TODO_VERIFY: Chainlit uses the gRPC proto path, confirm the auth handshake with Monetzly before relying on this in production.

# No Python SDK. Generate stubs from tps_alter.proto and drive ProcessStream
# (see the FastAPI page for the full bidi loop), then in a Chainlit handler:
#
#   msg = cl.Message(content="")
#   async for token in inject(llm_tokens, prompt, session_id, api_key):
#       await msg.stream_token(token)
#   await msg.send()
#
# TODO_VERIFY: auth handshake (API key placement) for a direct gRPC client.