Streaming responses in FastAPI - Performance & Optimization

Performance: Streaming responses

MEDIUM IMPACT

Streaming responses affect how quickly the user starts receiving data and how smoothly the content loads over time.

Sending large data or long processing results to the client

FastAPI

from fastapi import FastAPI
from fastapi.responses import StreamingResponse
import asyncio

app = FastAPI()

async def data_generator():
    for i in range(10):
        yield f'data chunk {i}\n'
        await asyncio.sleep(0.1)

@app.get('/stream')
async def stream_data():
    return StreamingResponse(data_generator(), media_type='text/plain')

Sends data chunks as soon as they are ready, allowing the browser to start rendering early.

📈 Performance GainReduces LCP by delivering first bytes immediately, improving user experience.

Sending large data or long processing results to the client

FastAPI

from fastapi import FastAPI
app = FastAPI()

@app.get('/data')
async def get_data():
    result = compute_large_data()
    return result

The server waits to finish all processing before sending any data, delaying the first byte to the client.

📉 Performance CostBlocks rendering until full data is ready, increasing LCP by hundreds of milliseconds or more.

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Full response after processing	Single DOM update after full data	Single reflow after full load	One large paint	[X] Bad
Streaming response with chunks	Incremental DOM updates as chunks arrive	Multiple small reflows	Multiple small paints	[OK] Good

Rendering Pipeline

Streaming responses send partial data progressively, allowing the browser to start parsing and rendering before the full response arrives.

→Network

→HTML Parsing

→Rendering

⚠️ BottleneckNetwork latency and server processing before first chunk

Core Web Vital Affected

LCP

Streaming responses affect how quickly the user starts receiving data and how smoothly the content loads over time.

Optimization Tips

1Use StreamingResponse to send data chunks as soon as they are ready.

2Avoid waiting for full data before responding to reduce LCP.

3Test streaming endpoints in DevTools Network tab to verify chunked delivery.

Performance Quiz - 3 Questions

How do streaming responses affect Largest Contentful Paint (LCP)?

A It improves LCP by sending data chunks early so content appears faster.

B It worsens LCP because it delays sending the full content.

C It has no effect on LCP since content is the same.

D It only affects interaction responsiveness, not LCP.

DevTools: Network

How to check: Open DevTools, go to Network tab, reload the streaming endpoint, and observe the timing waterfall for incremental data chunks.

What to look for: Look for early 'First Byte' and multiple small data packets arriving over time indicating streaming.