---
id: streamlit-pdf
version: "2.0.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# streamlit-pdf — A Streamlit component for viewing PDF files

License: permissive · Maintenance: active · Downloads: 97.8K/mo

## What it is and what it does

streamlit-pdf is a Streamlit component that embeds a PDF viewer directly into Streamlit web apps. It accepts PDFs from multiple sources—URLs, local file paths, file-like objects from st.file_uploader, or raw bytes—and renders them in an interactive viewer with a configurable height parameter (default 600 pixels). The component handles the rendering client-side, allowing users to scroll, zoom, and navigate through PDF documents without leaving the Streamlit app.

The package is lightweight with no runtime dependencies beyond Streamlit itself, making it straightforward to add to existing projects. It's designed for developers building document-viewing features into data apps, dashboards, or report generators. The component is in active development (Alpha status) and maintained by the Streamlit team.

Use it for:

- Display uploaded PDF reports or documents in a Streamlit dashboard without requiring external file downloads
- Embed hosted PDF documentation or guides directly in a web app for inline reference
- Build a document review interface where users upload PDFs and view them side-by-side with analysis results
- Show generated PDF reports (e.g., from a data processing pipeline) immediately after creation
- Create a simple PDF viewer app for browsing local or remote document collections

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds a PDF viewer component to Streamlit apps that displays PDF files from URLs, local paths, uploaded files, or raw bytes with configurable height.

Yes. Low install friction, no runtime dependencies, active maintenance, permissive license, and zero known vulnerabilities make this a safe choice. Install it if you need to display PDFs in a Streamlit app. The only caveat is Alpha status—expect the API or behavior to evolve, though the current interface is straightforward.

## Install

pip install streamlit-pdf
uv add streamlit-pdf
poetry add streamlit-pdf

## Installing streamlit-pdf

Before you install: Low friction installation as a wheel package. Actively maintained with recent releases; last commit 2026-08-14 and status marked active. No runtime dependencies to manage.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install streamlit-pdf

import streamlit as st

st.pdf("https://example.com/document.pdf", height=600)

Requires Streamlit to be installed; streamlit-pdf is a component that extends Streamlit's functionality.

Verify before relying:

- Whether st.pdf() is a direct method on the streamlit module or requires additional setup beyond import
- Performance characteristics when displaying large PDF files or many PDFs in a single app
- Browser compatibility and rendering engine used for PDF display

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 97.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

streamlit pdf viewer, display pdf in streamlit, pdf component streamlit, embed pdf documents, streamlit file viewer, pdf display widget, streamlit-component, document-viewer

[View on SkillFed](https://skillfed.io/packages/streamlit-pdf) · [View on PyPI](https://pypi.org/project/streamlit-pdf/)