What happens to my Streamlit response if Monetzly is down?

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

Do I need a manual fallback in Streamlit?

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 Streamlit

This guide shows how to handle ad-injection errors in a Streamlit 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 Streamlit produces and streams responses.

Overview

Monetization should never break your Streamlit 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 Streamlit response rather than a broken request.

Streamlit apps are usually built for AI demos, internal LLM tools, and chat prototypes with st.chat_message, 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 Streamlit

Streamlit is Python, so there is no native SDK. Drive the shipped tps_alter.proto gRPC service from Python (or a Node sidecar) and render the injected tokens with st.write_stream. Confirm the non-JS auth handshake before publishing.

Since Streamlit 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 Streamlit 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: Streamlit 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:
#
#   import streamlit as st
#   st.write_stream(inject(llm_tokens, prompt, session_id, api_key))
#
# TODO_VERIFY: auth handshake (API key placement) for a direct gRPC client.