llama-index-tools-brewpage

LlamaIndex tool spec that publishes HTML, Markdown, JSON, key-value stores and files to BrewPage and returns a shareable URL. Free, no account, no API key.

Install

pip install llama-index-tools-brewpage

Usage

from llama_index.tools.brewpage import BrewPageToolSpec

spec = BrewPageToolSpec()
page = spec.publish_page("# Weekly report\n\nAll green.", format="markdown")
print(page["url"])

With an agent (any function-calling LLM):

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.tools.brewpage import BrewPageToolSpec

agent = FunctionAgent(tools=BrewPageToolSpec().to_tool_list(), llm=llm)
response = await agent.run("Write a one-page HTML changelog and publish it.")

Tools

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) come back as {"error": "..."} so the agent can react.

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

from llama_index.tools.brewpage import BrewPageClient, BrewPageToolSpec

spec = BrewPageToolSpec(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
• langchain-brewpage: the same tools for LangChain (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