swarmauri_tool_downloadpdf 0.10.0.dev3

Swarmauri Community Download PDF Tool

---

Swarmauri Tool Download PDF

Tool that downloads a PDF by URL and returns the file contents as a base64-encoded string, enabling downstream storage or inline embedding without touching disk.

Features

• Uses requests to stream PDF bytes.
• Encodes the result into base64 (content field) and includes a success message.
• Returns an error key when download or processing fails.

Prerequisites

• Python 3.10 or newer.
• requests (installed automatically).
• Network access to the target PDF URL.

Installation

# pip
pip install swarmauri_tool_downloadpdf

# poetry
poetry add swarmauri_tool_downloadpdf

# uv (pyproject-based projects)
uv add swarmauri_tool_downloadpdf

Quickstart

import base64
from pathlib import Path
from swarmauri_tool_downloadpdf import DownloadPDFTool

tool = DownloadPDFTool()
result = tool("https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf")

if "error" in result:
    print(result["error"])
else:
    pdf_bytes = base64.b64decode(result["content"])
    Path("downloaded.pdf").write_bytes(pdf_bytes)

Tips

• Always check for the error key before assuming the download succeeded.
• Large PDFs load into memory—consider chunking or alternative tools if you need to stream huge files directly to disk.
• Validate URLs to avoid downloading untrusted content when wiring this tool into automated pipelines.

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.