langchain-brewpage

LangChain tools that publish HTML, Markdown, JSON, key-value stores and files to BrewPage and return a shareable URL. Free, no account, no API key.

Install

pip install langchain-brewpage

Usage

from langchain_brewpage import BrewPageToolkit

tools = BrewPageToolkit().get_tools()
page = tools[0].invoke({"content": "# Weekly report\n\nAll green.", "format": "markdown"})
print(page["url"])

With an agent (any tool-calling chat model):

from langchain.agents import create_agent
from langchain_brewpage import BrewPageToolkit

agent = create_agent(model, tools=BrewPageToolkit().get_tools())
agent.invoke({"messages": [{"role": "user", "content": "Write a one-page HTML changelog and publish it."}]})

Tools

BrewPageToolkit returns all four with one shared client. Every tool also takes ttl_days, password and namespace and returns a dict with url, id, namespace, owner_token, management_link, expires_at. API errors (rate limits, refused content) reach the agent as tool messages, not exceptions.

The first call gets an owner token; the toolkit reuses it, so all publications share one owner. To keep it across runs, pass it in:

from langchain_brewpage import BrewPageClient, BrewPageToolkit

toolkit = BrewPageToolkit(client=BrewPageClient(owner_token="..."))

Environment: BREWPAGE_OWNER_TOKEN, BREWPAGE_NAMESPACE, BREWPAGE_BASE_URL (default https://brewpage.app).

Limits

• Hosting is temporary: publications expire after 15 days by default, ttl_days 1-30.
• Without namespace a publication is private: unlisted and not indexed, but anyone with the link can open it. Add password to restrict reads.
• namespace="public" lists pages in the public gallery and search engines. Never put secrets or personal data there.
• Size caps: HTML 5 MB, JSON 1 MB, KV value 1 MB, file 5 MB (video 20 MB). Current values: brewpage.app/api/limits.

Related

• BrewPage and its API
• API reference
• llama-index-tools-brewpage: the same tools for LlamaIndex (PyPI)
• brewpage-publish-plugins: other integrations
• brewpage-mcp: MCP server on npm; source and OpenAPI contract in brewpage-openapi
• brewpage-action: GitHub Action that publishes CI artifacts (Marketplace)
• brewpage-cookbook: interactive recipes published on BrewPage
• brewpage-obsidian: Obsidian plugin that publishes notes (Obsidian community)
• brewpage-browser-extension: browser extension that publishes pages, selections and files
• brewpage-codex-plugin: Codex plugin with the publishing skill and remote MCP

Development

uv sync --group test
uv run pytest
BREWPAGE_LIVE=1 uv run pytest -m live   # publishes one private page on production

Support

info@brewpage.app or GitHub issues.

License

MIT