Give your agents and pipelines
visual web perception

import asyncio, httpx

async def screenshot_pipeline(urls: list[str], api_key: str):
    """Non-blocking: submit all jobs, then gather results."""
    async with httpx.AsyncClient() as client:
        headers = {"X-API-Key": api_key, "Content-Type": "application/json"}

        # Submit all jobs without waiting
        jobs = []
        for url in urls:
            r = await client.post(
                "https://hermesforge.dev/api/screenshot/queue",
                json={"url": url, "format": "webp"},
                headers=headers,
            )
            jobs.append(r.json()["job_id"])

        # Poll until all done
        results = {}
        while jobs:
            await asyncio.sleep(2)
            still_pending = []
            for job_id in jobs:
                s = await client.get(
                    f"https://hermesforge.dev/api/screenshot/status/{job_id}",
                    headers=headers,
                )
                data = s.json()
                if data["status"] == "done":
                    results[job_id] = f"https://hermesforge.dev/api/screenshot/result/{job_id}"
                elif data["status"] == "pending":
                    still_pending.append(job_id)
            jobs = still_pending
        return results

from fastapi import FastAPI, Request
import httpx

app = FastAPI()

# 1. Submit a job with your webhook URL
async def queue_screenshot(url: str, api_key: str):
    async with httpx.AsyncClient() as client:
        r = await client.post(
            "https://hermesforge.dev/api/screenshot/queue",
            json={
                "url": url,
                "format": "webp",
                "webhook_url": "https://yourapp.com/api/screenshot-done",
            },
            headers={"X-API-Key": api_key},
        )
    return r.json()["job_id"]  # returns immediately

# 2. Receive the result when it's ready
@app.post("/api/screenshot-done")
async def screenshot_done(request: Request):
    data = await request.json()
    # data = {"job_id": "...", "status": "done",
    #         "result_url": "https://hermesforge.dev/api/screenshot/result/..."}
    result_url = data["result_url"]
    # Fetch and store, pass to LLM, etc.
    return {"ok": True}

# pip install langchain-hermes
# or: pip install https://hermesforge.dev/packages/langchain_hermes-0.1.0-py3-none-any.whl

from langchain_hermes import HermesScreenshotTool, HermesAsyncScreenshotTool
from langchain_core.agents import create_tool_calling_agent

# Sync tool — returns base64 data URL (works with multimodal LLMs)
screenshot = HermesScreenshotTool(api_key="YOUR_KEY")

# Async queue tool — non-blocking, returns job_id + status_url
screenshot_async = HermesAsyncScreenshotTool(
    api_key="YOUR_KEY",
    poll_for_result=True,   # True = block until done, return result URL
)

# Add to any LangChain agent
tools = [screenshot]
agent = create_tool_calling_agent(llm=your_llm, tools=tools, prompt=your_prompt)

# Direct use
data_url = screenshot.run({"url": "https://example.com", "full_page": True})
# → "data:image/webp;base64,..."

curl -X POST https://hermesforge.dev/api/charts/render \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "type": "bar",
      "data": {
        "labels": ["Jan","Feb","Mar","Apr","May"],
        "datasets": [{"label":"Revenue","data":[4200,5100,4800,6300,7100],"backgroundColor":"#3fb950"}]
      }
    },
    "format": "png",
    "width": 800,
    "height": 400
  }' \
  --output chart.png

import requests

config = {
    "type": "line",
    "data": {
        "labels": ["Mon", "Tue", "Wed", "Thu", "Fri"],
        "datasets": [{
            "label": "API calls",
            "data": [120, 145, 98, 210, 187],
            "borderColor": "#58a6ff",
            "fill": False
        }]
    }
}

resp = requests.post(
    "https://hermesforge.dev/api/charts/render",
    json={"config": config, "format": "png", "width": 800, "height": 400},
    headers={"X-API-Key": "YOUR_KEY"}
)
with open("chart.png", "wb") as f:
    f.write(resp.content)  # binary PNG

const resp = await fetch('https://hermesforge.dev/api/charts/render', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    config: {
      type: 'doughnut',
      data: {
        labels: ['Screenshot', 'Chart', 'Other'],
        datasets: [{ data: [62, 28, 10], backgroundColor: ['#3fb950', '#f78166', '#58a6ff'] }]
      }
    },
    format: 'png', width: 600, height: 400
  })
});
const blob = await resp.blob();
const url = URL.createObjectURL(blob);  // use as <img src>