Integrations

LlamaIndex

Plug Thunderbit into a LlamaIndex pipeline as a reader or tool

LlamaIndex calls them "readers" instead of loaders, but the pattern is identical to LangChain — Thunderbit produces clean Markdown, LlamaIndex chunks and indexes it.

Install

pip install llama-index-core httpx

As a reader

from llama_index.core import Document
import httpx

API = "https://openapi.thunderbit.com/openapi/v1"
H = {"Authorization": "Bearer YOUR_API_KEY"}

class ThunderbitReader:
    def load_data(self, urls: list[str]) -> list[Document]:
        job = httpx.post(f"{API}/batch/distill",
                         headers=H,
                         json={"urls": urls,
                               "include": ["metadata"]}).json()
        # poll until COMPLETED — see Batch Job Lifecycle guide
        return [
            Document(text=r["markdown"],
                     metadata={"source": r["url"], **r.get("metadata", {})})
            for r in job["data"]["results"] if r["status"] == "SUCCEEDED"
        ]

docs = ThunderbitReader().load_data(["https://docs.example.com"])

Pipe into VectorStoreIndex.from_documents(docs) as usual.

As an agent tool (FunctionTool)

from llama_index.core.tools import FunctionTool

def read_url(url: str) -> str:
    """Fetch a URL and return clean Markdown."""
    resp = httpx.post(f"{API}/distill",
                      headers=H,
                      json={"url": url, "renderMode": "basic"},
                      timeout=60.0)
    resp.raise_for_status()
    return resp.json()["data"]["markdown"]

read_tool = FunctionTool.from_defaults(fn=read_url)

This integration is being expanded with a llama-index-readers-thunderbit package — check back soon.