swarmauri_tool_qrcodegenerator 0.11.0.dev1

Swarmauri utility tool for generating QR codes and returning base64-encoded image bytes.

Swarmauri Tool QR Code Generator

swarmauri_tool_qrcodegenerator is a Swarmauri utility tool for generating QR codes from text payloads and returning the resulting image bytes as a base64-encoded string. It is useful for links, identifiers, tickets, device pairing flows, and automation pipelines that need scannable data artifacts.

Why Use Swarmauri Tool QR Code Generator

• Turn text values into scannable QR artifacts inside Swarmauri workflows.
• Return image data inline as base64 for transport-friendly downstream use.
• Generate QR content for tickets, links, tokens, or device onboarding.
• Keep QR generation available as a standard Swarmauri tool interface.

FAQ

What input does the tool expect?
A single string data value to encode.

What does the tool return?
A dictionary with one key: image_b64.

Does the tool currently write files to disk?
No. It returns encoded image bytes in memory.

Can this be used in agent workflows?
Yes. The base64 string can be forwarded to other tools, APIs, or UI layers.

Features

• Swarmauri ToolBase implementation registered as QrCodeGeneratorTool.
• Generates QR codes from arbitrary text input.
• Returns base64-encoded image bytes for transport and storage.
• Useful for event, device, credential, and link-sharing workflows.
• Supports Python 3.10, 3.11, 3.12, 3.13, and 3.14.

Installation

uv add swarmauri_tool_qrcodegenerator

pip install swarmauri_tool_qrcodegenerator

Usage

from swarmauri_tool_qrcodegenerator import QrCodeGeneratorTool

tool = QrCodeGeneratorTool()
result = tool("https://docs.swarmauri.com")

print(result["image_b64"][:40])

Examples

Generate a QR code for a URL

from swarmauri_tool_qrcodegenerator import QrCodeGeneratorTool

tool = QrCodeGeneratorTool()
result = tool("https://example.com")

print(len(result["image_b64"]))

Encode an onboarding token

from swarmauri_tool_qrcodegenerator import QrCodeGeneratorTool

tool = QrCodeGeneratorTool()
token = "device:pairing:ABC123XYZ"
result = tool(token)

print(result.keys())

Register the tool in a Swarmauri collection

from swarmauri_standard.tools.ToolCollection import ToolCollection
from swarmauri_tool_qrcodegenerator import QrCodeGeneratorTool

tools = ToolCollection(tools=[QrCodeGeneratorTool()])
print(tools)

Related Packages

• swarmauri_tool_zapierhook
• swarmauri_tool_webscraping
• swarmauri_tool_downloadpdf

Swarmauri Foundations

• swarmauri
• swarmauri_core
• swarmauri_base
• swarmauri_standard

More Documentation

• qrcode package documentation
• Base64 encoding in Python
• Swarmauri SDK repository

Best Practices

• Keep encoded payloads short enough for compact QR generation.
• Validate how your downstream consumer expects to reconstruct the returned image bytes.
• Avoid embedding secrets directly unless the QR code lifecycle is controlled.
• Consider extending the tool if you need explicit PNG serialization options.

License

This project is licensed under the Apache-2.0 License.