gui-now 1.0.0__tar.gz

gui_now-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stratus Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gui_now-1.0.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: gui-now
+Version: 1.0.0
+Summary: Python SDK + agent tools for gui.now — instant shareable HTML canvases
+License: MIT
+Project-URL: Homepage, https://gui.now
+Project-URL: Repository, https://github.com/gui-now/python
+Keywords: gui-now,html,canvas,sharing,langchain,llamaindex,crewai,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
+Requires-Dist: pydantic>=2.0; extra == "langchain"
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.10.0; extra == "llamaindex"
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.1.0; extra == "crewai"
+Requires-Dist: pydantic>=2.0; extra == "crewai"
+Provides-Extra: all
+Requires-Dist: langchain-core>=0.1.0; extra == "all"
+Requires-Dist: llama-index-core>=0.10.0; extra == "all"
+Requires-Dist: crewai>=0.1.0; extra == "all"
+Requires-Dist: pydantic>=2.0; extra == "all"
+Dynamic: license-file
+
+# gui-now
+
+Python SDK + agent tools for [GUI](https://gui.now) — instant shareable HTML canvases.
+
+## Install
+
+```bash
+pip install gui-now
+```
+
+With framework integrations:
+
+```bash
+pip install gui-now[langchain]
+pip install gui-now[llamaindex]
+pip install gui-now[crewai]
+pip install gui-now[all]
+```
+
+## Quick Start
+
+```python
+from guinow import create_canvas
+
+url = create_canvas(html="<h1>Hello World</h1>", title="My Canvas")
+print(url)  # https://gui.now/abc123
+```
+
+### Full Client
+
+```python
+from guinow import GuiNowClient
+
+client = GuiNowClient(api_key="your-pro-key")  # or set GUI_NOW_API_KEY env var
+result = client.create(
+    html="<h1>Dashboard</h1>",
+    title="Q1 Report",
+    expires="7d",
+)
+print(result.url)
+print(result.expires_at)
+```
+
+### Every input format
+
+```python
+client.create(html="<h1>Hi</h1>")                       # raw HTML
+client.create(markdown="# Hi\n\nRendered server-side.")  # Markdown
+client.create_diagram("graph TD\n  A-->B", title="Flow")  # Mermaid
+client.create(frames=[                                   # multi-tab canvas
+    {"html": "<h1>Overview</h1>", "label": "Overview"},
+    {"html": "<h1>Detail</h1>", "label": "Detail"},
+])
+```
+
+### Update and extend
+
+`create()` returns an `edit_token`. Keep it — it is the only way to change a
+canvas afterwards. Free tier allows 3 edits per canvas; Pro is unlimited.
+
+```python
+canvas = client.create(html="<h1>Draft</h1>")
+
+client.update(canvas.id, canvas.edit_token, html="<h1>Final</h1>")
+client.update(canvas.id, canvas.edit_token, title="Renamed")
+client.update(canvas.id, canvas.edit_token, password=None)  # remove protection
+
+client.extend(canvas.id)   # push expiry to 24h from now
+canvas.open()              # open the URL in a browser
+```
+
+Omitting `password` leaves existing protection alone; passing `None` removes it.
+
+## LangChain
+
+```python
+from guinow.langchain import GuiNowTool
+
+tool = GuiNowTool()
+# Add to your agent's tools list
+agent = initialize_agent(tools=[tool], ...)
+```
+
+## LlamaIndex
+
+```python
+from guinow.llamaindex import get_guinow_tool
+
+tool = get_guinow_tool()
+agent = ReActAgent.from_tools([tool], ...)
+```
+
+## CrewAI
+
+```python
+from guinow.crewai import GuiNowTool
+
+tool = GuiNowTool()
+agent = Agent(tools=[tool], ...)
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GUI_NOW_API_KEY` | Pro API key for higher rate limits and longer expiry |
+| `GUI_NOW_URL` | Override the API base URL (defaults to `https://gui.now`) |
+
+`GUI_NEW_API_KEY` and `GUI_NEW_URL` are the pre-rename names and are still read
+as fallbacks, so keys exported before the move to gui.now keep working.
+
+## License
+
+MIT

gui_now-1.0.0/README.md

@@ -0,0 +1,114 @@
+# gui-now
+
+Python SDK + agent tools for [GUI](https://gui.now) — instant shareable HTML canvases.
+
+## Install
+
+```bash
+pip install gui-now
+```
+
+With framework integrations:
+
+```bash
+pip install gui-now[langchain]
+pip install gui-now[llamaindex]
+pip install gui-now[crewai]
+pip install gui-now[all]
+```
+
+## Quick Start
+
+```python
+from guinow import create_canvas
+
+url = create_canvas(html="<h1>Hello World</h1>", title="My Canvas")
+print(url)  # https://gui.now/abc123
+```
+
+### Full Client
+
+```python
+from guinow import GuiNowClient
+
+client = GuiNowClient(api_key="your-pro-key")  # or set GUI_NOW_API_KEY env var
+result = client.create(
+    html="<h1>Dashboard</h1>",
+    title="Q1 Report",
+    expires="7d",
+)
+print(result.url)
+print(result.expires_at)
+```
+
+### Every input format
+
+```python
+client.create(html="<h1>Hi</h1>")                       # raw HTML
+client.create(markdown="# Hi\n\nRendered server-side.")  # Markdown
+client.create_diagram("graph TD\n  A-->B", title="Flow")  # Mermaid
+client.create(frames=[                                   # multi-tab canvas
+    {"html": "<h1>Overview</h1>", "label": "Overview"},
+    {"html": "<h1>Detail</h1>", "label": "Detail"},
+])
+```
+
+### Update and extend
+
+`create()` returns an `edit_token`. Keep it — it is the only way to change a
+canvas afterwards. Free tier allows 3 edits per canvas; Pro is unlimited.
+
+```python
+canvas = client.create(html="<h1>Draft</h1>")
+
+client.update(canvas.id, canvas.edit_token, html="<h1>Final</h1>")
+client.update(canvas.id, canvas.edit_token, title="Renamed")
+client.update(canvas.id, canvas.edit_token, password=None)  # remove protection
+
+client.extend(canvas.id)   # push expiry to 24h from now
+canvas.open()              # open the URL in a browser
+```
+
+Omitting `password` leaves existing protection alone; passing `None` removes it.
+
+## LangChain
+
+```python
+from guinow.langchain import GuiNowTool
+
+tool = GuiNowTool()
+# Add to your agent's tools list
+agent = initialize_agent(tools=[tool], ...)
+```
+
+## LlamaIndex
+
+```python
+from guinow.llamaindex import get_guinow_tool
+
+tool = get_guinow_tool()
+agent = ReActAgent.from_tools([tool], ...)
+```
+
+## CrewAI
+
+```python
+from guinow.crewai import GuiNowTool
+
+tool = GuiNowTool()
+agent = Agent(tools=[tool], ...)
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GUI_NOW_API_KEY` | Pro API key for higher rate limits and longer expiry |
+| `GUI_NOW_URL` | Override the API base URL (defaults to `https://gui.now`) |
+
+`GUI_NEW_API_KEY` and `GUI_NEW_URL` are the pre-rename names and are still read
+as fallbacks, so keys exported before the move to gui.now keep working.
+
+## License
+
+MIT

gui_now-1.0.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gui-now"
+version = "1.0.0"
+description = "Python SDK + agent tools for gui.now — instant shareable HTML canvases"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+keywords = ["gui-now", "html", "canvas", "sharing", "langchain", "llamaindex", "crewai", "agent"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+
+[project.optional-dependencies]
+langchain = ["langchain-core>=0.1.0", "pydantic>=2.0"]
+llamaindex = ["llama-index-core>=0.10.0"]
+crewai = ["crewai>=0.1.0", "pydantic>=2.0"]
+all = ["langchain-core>=0.1.0", "llama-index-core>=0.10.0", "crewai>=0.1.0", "pydantic>=2.0"]
+
+[project.urls]
+Homepage = "https://gui.now"
+Repository = "https://github.com/gui-now/python"
+
+[tool.setuptools.packages.find]
+where = ["src"]

gui_now-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gui_now-1.0.0/src/gui_now.egg-info/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: gui-now
+Version: 1.0.0
+Summary: Python SDK + agent tools for gui.now — instant shareable HTML canvases
+License: MIT
+Project-URL: Homepage, https://gui.now
+Project-URL: Repository, https://github.com/gui-now/python
+Keywords: gui-now,html,canvas,sharing,langchain,llamaindex,crewai,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
+Requires-Dist: pydantic>=2.0; extra == "langchain"
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.10.0; extra == "llamaindex"
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.1.0; extra == "crewai"
+Requires-Dist: pydantic>=2.0; extra == "crewai"
+Provides-Extra: all
+Requires-Dist: langchain-core>=0.1.0; extra == "all"
+Requires-Dist: llama-index-core>=0.10.0; extra == "all"
+Requires-Dist: crewai>=0.1.0; extra == "all"
+Requires-Dist: pydantic>=2.0; extra == "all"
+Dynamic: license-file
+
+# gui-now
+
+Python SDK + agent tools for [GUI](https://gui.now) — instant shareable HTML canvases.
+
+## Install
+
+```bash
+pip install gui-now
+```
+
+With framework integrations:
+
+```bash
+pip install gui-now[langchain]
+pip install gui-now[llamaindex]
+pip install gui-now[crewai]
+pip install gui-now[all]
+```
+
+## Quick Start
+
+```python
+from guinow import create_canvas
+
+url = create_canvas(html="<h1>Hello World</h1>", title="My Canvas")
+print(url)  # https://gui.now/abc123
+```
+
+### Full Client
+
+```python
+from guinow import GuiNowClient
+
+client = GuiNowClient(api_key="your-pro-key")  # or set GUI_NOW_API_KEY env var
+result = client.create(
+    html="<h1>Dashboard</h1>",
+    title="Q1 Report",
+    expires="7d",
+)
+print(result.url)
+print(result.expires_at)
+```
+
+### Every input format
+
+```python
+client.create(html="<h1>Hi</h1>")                       # raw HTML
+client.create(markdown="# Hi\n\nRendered server-side.")  # Markdown
+client.create_diagram("graph TD\n  A-->B", title="Flow")  # Mermaid
+client.create(frames=[                                   # multi-tab canvas
+    {"html": "<h1>Overview</h1>", "label": "Overview"},
+    {"html": "<h1>Detail</h1>", "label": "Detail"},
+])
+```
+
+### Update and extend
+
+`create()` returns an `edit_token`. Keep it — it is the only way to change a
+canvas afterwards. Free tier allows 3 edits per canvas; Pro is unlimited.
+
+```python
+canvas = client.create(html="<h1>Draft</h1>")
+
+client.update(canvas.id, canvas.edit_token, html="<h1>Final</h1>")
+client.update(canvas.id, canvas.edit_token, title="Renamed")
+client.update(canvas.id, canvas.edit_token, password=None)  # remove protection
+
+client.extend(canvas.id)   # push expiry to 24h from now
+canvas.open()              # open the URL in a browser
+```
+
+Omitting `password` leaves existing protection alone; passing `None` removes it.
+
+## LangChain
+
+```python
+from guinow.langchain import GuiNowTool
+
+tool = GuiNowTool()
+# Add to your agent's tools list
+agent = initialize_agent(tools=[tool], ...)
+```
+
+## LlamaIndex
+
+```python
+from guinow.llamaindex import get_guinow_tool
+
+tool = get_guinow_tool()
+agent = ReActAgent.from_tools([tool], ...)
+```
+
+## CrewAI
+
+```python
+from guinow.crewai import GuiNowTool
+
+tool = GuiNowTool()
+agent = Agent(tools=[tool], ...)
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GUI_NOW_API_KEY` | Pro API key for higher rate limits and longer expiry |
+| `GUI_NOW_URL` | Override the API base URL (defaults to `https://gui.now`) |
+
+`GUI_NEW_API_KEY` and `GUI_NEW_URL` are the pre-rename names and are still read
+as fallbacks, so keys exported before the move to gui.now keep working.
+
+## License
+
+MIT

gui_now-1.0.0/src/gui_now.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/gui_now.egg-info/PKG-INFO
+src/gui_now.egg-info/SOURCES.txt
+src/gui_now.egg-info/dependency_links.txt
+src/gui_now.egg-info/requires.txt
+src/gui_now.egg-info/top_level.txt
+src/guinow/__init__.py
+src/guinow/client.py
+src/guinow/crewai.py
+src/guinow/langchain.py
+src/guinow/llamaindex.py

gui_now-1.0.0/src/gui_now.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gui_now-1.0.0/src/gui_now.egg-info/requires.txt

@@ -0,0 +1,17 @@
+
+[all]
+langchain-core>=0.1.0
+llama-index-core>=0.10.0
+crewai>=0.1.0
+pydantic>=2.0
+
+[crewai]
+crewai>=0.1.0
+pydantic>=2.0
+
+[langchain]
+langchain-core>=0.1.0
+pydantic>=2.0
+
+[llamaindex]
+llama-index-core>=0.10.0

gui_now-1.0.0/src/gui_now.egg-info/top_level.txt

@@ -0,0 +1 @@
+guinow

gui_now-1.0.0/src/guinow/__init__.py

@@ -0,0 +1,26 @@
+"""gui.now Python SDK — create shareable HTML canvases."""
+
+from guinow.client import (
+    CanvasResult,
+    GuiNowClient,
+    GuiNowError,
+    RateLimitError,
+    create,
+    create_canvas,
+    create_diagram,
+    extend,
+    update,
+)
+
+__all__ = [
+    "CanvasResult",
+    "GuiNowClient",
+    "GuiNowError",
+    "RateLimitError",
+    "create",
+    "create_canvas",
+    "create_diagram",
+    "extend",
+    "update",
+]
+__version__ = "1.0.0"

gui_now-1.0.0/src/guinow/client.py

@@ -0,0 +1,261 @@
+"""Core client for the gui.now API."""
+
+from __future__ import annotations
+
+import json
+import os
+import urllib.error
+import urllib.request
+from dataclasses import dataclass
+from typing import Any, Optional
+
+
+DEFAULT_BASE_URL = "https://gui.now"
+
+
+def _default_base_url() -> str:
+    # GUI_NEW_URL is the pre-rename name; still honoured so existing setups
+    # keep working without the user having to re-export anything.
+    return (
+        os.environ.get("GUI_NOW_URL")
+        or os.environ.get("GUI_NEW_URL")
+        or DEFAULT_BASE_URL
+    )
+
+
+def _default_api_key() -> Optional[str]:
+    # GUI_NEW_API_KEY is the pre-rename name; see above.
+    return os.environ.get("GUI_NOW_API_KEY") or os.environ.get("GUI_NEW_API_KEY")
+
+
+@dataclass
+class CanvasResult:
+    id: str
+    url: str
+    edit_token: str
+    expires_at: str
+    pro: bool
+    format: str
+    password_protected: bool = False
+
+    def open(self) -> None:
+        """Open the canvas URL in the default browser."""
+        import webbrowser
+
+        webbrowser.open(self.url)
+
+
+class GuiNowError(Exception):
+    pass
+
+
+class RateLimitError(GuiNowError):
+    def __init__(self, retry_after: str = "3600"):
+        self.retry_after = retry_after
+        super().__init__(f"Rate limited. Retry after {retry_after} seconds.")
+
+
+class _Unset:
+    """Sentinel so update() can tell 'omitted' from an explicit None."""
+
+    def __repr__(self) -> str:  # pragma: no cover - debugging aid
+        return "<unset>"
+
+
+_UNSET = _Unset()
+
+
+class GuiNowClient:
+    """Client for the gui.now API."""
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        base_url: Optional[str] = None,
+    ):
+        self.api_key = api_key or _default_api_key()
+        self.base_url = (base_url or _default_base_url()).rstrip("/")
+
+    # ---- create -----------------------------------------------------------
+
+    def create(
+        self,
+        *,
+        html: Optional[str] = None,
+        markdown: Optional[str] = None,
+        mermaid: Optional[str] = None,
+        frames: Optional[list] = None,
+        title: Optional[str] = None,
+        theme: Optional[str] = None,
+        expires: Optional[str] = None,
+        password: Optional[str] = None,
+    ) -> CanvasResult:
+        """Create a canvas.
+
+        Exactly one content argument is needed:
+            html:     raw HTML.
+            markdown: Markdown, rendered server-side.
+            mermaid:  a Mermaid diagram, rendered pannable and zoomable.
+            frames:   multi-tab views, [{"html": ..., "label": ...}, ...].
+
+        Args:
+            title:    display name for the toolbar and OG meta.
+            theme:    "dark" (default) or "light".
+            expires:  Pro only: "1h", "24h", "7d", "14d", "30d".
+            password: Pro only: password-protect the canvas.
+        """
+        body: dict[str, Any] = {}
+        if html is not None:
+            body["html"] = html
+        if markdown is not None:
+            body["markdown"] = markdown
+        if mermaid is not None:
+            body["mermaid"] = mermaid
+        if frames is not None:
+            body["frames"] = frames
+        if title is not None:
+            body["title"] = title
+        if theme is not None:
+            body["theme"] = theme
+        if expires is not None:
+            body["expires"] = expires
+        if password is not None:
+            body["password"] = password
+
+        if not any(
+            body.get(k) for k in ("html", "markdown", "mermaid", "frames")
+        ):
+            raise GuiNowError(
+                "One of html, markdown, mermaid or frames is required"
+            )
+
+        return _parse(self._request("POST", "/api/canvas", body))
+
+    def create_diagram(
+        self,
+        mermaid: str,
+        *,
+        title: Optional[str] = None,
+        theme: Optional[str] = None,
+    ) -> CanvasResult:
+        """Create a Mermaid diagram canvas."""
+        return self.create(mermaid=mermaid, title=title, theme=theme)
+
+    # ---- update -----------------------------------------------------------
+
+    def update(
+        self,
+        canvas_id: str,
+        edit_token: str,
+        *,
+        html: Optional[str] = None,
+        title: Optional[str] = None,
+        frames: Optional[list] = None,
+        password: Any = _UNSET,
+    ) -> dict:
+        """Replace a canvas's content. Free tier allows 3 edits; Pro unlimited.
+
+        Pass password=None to remove password protection, or omit it to leave
+        whatever protection the canvas already has untouched.
+        """
+        body: dict[str, Any] = {}
+        if html is not None:
+            body["html"] = html
+        if title is not None:
+            body["title"] = title
+        if frames is not None:
+            body["frames"] = frames
+        if password is not _UNSET:
+            body["password"] = password
+
+        if not body:
+            raise GuiNowError("update needs at least one field to change")
+
+        return self._request(
+            "PUT",
+            f"/api/canvas/{canvas_id}",
+            body,
+            headers={"Authorization": f"Bearer {edit_token}"},
+        )
+
+    def extend(self, canvas_id: str) -> dict:
+        """Extend the canvas expiry to 24 hours from now."""
+        return self._request("POST", f"/api/canvas/{canvas_id}/extend", {})
+
+    # ---- transport --------------------------------------------------------
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        body: dict,
+        headers: Optional[dict] = None,
+    ) -> dict:
+        req_headers = {"Content-Type": "application/json"}
+        if self.api_key:
+            req_headers["x-api-key"] = self.api_key
+        if headers:
+            req_headers.update(headers)
+
+        req = urllib.request.Request(
+            f"{self.base_url}{path}",
+            data=json.dumps(body).encode("utf-8"),
+            headers=req_headers,
+            method=method,
+        )
+
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            if e.code == 429:
+                raise RateLimitError(e.headers.get("Retry-After", "3600")) from e
+            detail = e.read().decode("utf-8", errors="replace")
+            try:
+                detail = json.loads(detail).get("error", detail)
+            except json.JSONDecodeError:
+                pass
+            raise GuiNowError(f"API error ({e.code}): {detail}") from e
+
+
+def _parse(d: dict) -> CanvasResult:
+    return CanvasResult(
+        id=d["id"],
+        url=d["url"],
+        edit_token=d["edit_token"],
+        expires_at=d["expires_at"],
+        pro=d.get("pro", False),
+        format=d.get("format", "html"),
+        password_protected=d.get("password_protected", False),
+    )
+
+
+# ---- module-level conveniences using a default client ---------------------
+
+
+def create(**kwargs) -> CanvasResult:
+    return GuiNowClient().create(**kwargs)
+
+
+def create_diagram(mermaid: str, **kwargs) -> CanvasResult:
+    return GuiNowClient().create_diagram(mermaid, **kwargs)
+
+
+def update(canvas_id: str, edit_token: str, **kwargs) -> dict:
+    return GuiNowClient().update(canvas_id, edit_token, **kwargs)
+
+
+def extend(canvas_id: str) -> dict:
+    return GuiNowClient().extend(canvas_id)
+
+
+def create_canvas(
+    html: Optional[str] = None,
+    markdown: Optional[str] = None,
+    title: Optional[str] = None,
+    expires: Optional[str] = None,
+) -> str:
+    """Quick helper — create a canvas and return just the URL."""
+    return GuiNowClient().create(
+        html=html, markdown=markdown, title=title, expires=expires
+    ).url

gui_now-1.0.0/src/guinow/crewai.py

@@ -0,0 +1,47 @@
+"""CrewAI tool for gui.now."""
+
+from __future__ import annotations
+
+from typing import Optional, Type
+
+try:
+    from crewai.tools import BaseTool
+    from pydantic import BaseModel, Field
+except ImportError:
+    raise ImportError(
+        "crewai and pydantic are required. "
+        "Install with: pip install gui-now[crewai]"
+    )
+
+from guinow.client import GuiNowClient
+
+
+class CreateCanvasInput(BaseModel):
+    html: Optional[str] = Field(None, description="Raw HTML content for the canvas")
+    markdown: Optional[str] = Field(None, description="Markdown content (rendered server-side)")
+    title: Optional[str] = Field(None, description="Optional canvas title")
+    expires: Optional[str] = Field(None, description="Expiry: 1h, 24h, 7d, 14d, 30d")
+
+
+class GuiNowTool(BaseTool):
+    """CrewAI tool to create shareable HTML canvases on gui.now."""
+
+    name: str = "create_gui_canvas"
+    description: str = (
+        "Create a shareable HTML canvas on gui.now. "
+        "Send HTML or Markdown content and get a live URL anyone can view. "
+        "Use for dashboards, reports, previews, or any visual output."
+    )
+    args_schema: Type[BaseModel] = CreateCanvasInput
+    api_key: Optional[str] = None
+
+    def _run(
+        self,
+        html: Optional[str] = None,
+        markdown: Optional[str] = None,
+        title: Optional[str] = None,
+        expires: Optional[str] = None,
+    ) -> str:
+        client = GuiNowClient(api_key=self.api_key)
+        result = client.create(html=html, markdown=markdown, title=title, expires=expires)
+        return f"Canvas created: {result.url} (expires {result.expires_at})"

gui_now-1.0.0/src/guinow/langchain.py

@@ -0,0 +1,47 @@
+"""LangChain tool for gui.now."""
+
+from __future__ import annotations
+
+from typing import Optional, Type
+
+try:
+    from langchain_core.tools import BaseTool
+    from pydantic import BaseModel, Field
+except ImportError:
+    raise ImportError(
+        "langchain_core and pydantic are required. "
+        "Install with: pip install gui-now[langchain]"
+    )
+
+from guinow.client import GuiNowClient
+
+
+class CreateCanvasInput(BaseModel):
+    html: Optional[str] = Field(None, description="Raw HTML content for the canvas")
+    markdown: Optional[str] = Field(None, description="Markdown content (rendered server-side)")
+    title: Optional[str] = Field(None, description="Optional canvas title")
+    expires: Optional[str] = Field(None, description="Expiry: 1h, 24h, 7d, 14d, 30d")
+
+
+class GuiNowTool(BaseTool):
+    """LangChain tool to create shareable HTML canvases on gui.now."""
+
+    name: str = "create_gui_canvas"
+    description: str = (
+        "Create a shareable HTML canvas on gui.now. "
+        "Send HTML or Markdown content and get a live URL anyone can view. "
+        "Use for dashboards, reports, previews, or any visual output."
+    )
+    args_schema: Type[BaseModel] = CreateCanvasInput
+    api_key: Optional[str] = None
+
+    def _run(
+        self,
+        html: Optional[str] = None,
+        markdown: Optional[str] = None,
+        title: Optional[str] = None,
+        expires: Optional[str] = None,
+    ) -> str:
+        client = GuiNowClient(api_key=self.api_key)
+        result = client.create(html=html, markdown=markdown, title=title, expires=expires)
+        return f"Canvas created: {result.url} (expires {result.expires_at})"

gui_now-1.0.0/src/guinow/llamaindex.py

@@ -0,0 +1,54 @@
+"""LlamaIndex tool for gui.now."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+try:
+    from llama_index.core.tools import FunctionTool
+except ImportError:
+    raise ImportError(
+        "llama_index is required. "
+        "Install with: pip install gui-now[llamaindex]"
+    )
+
+from guinow.client import GuiNowClient
+
+
+def _create_canvas(
+    html: str = "",
+    markdown: str = "",
+    title: str = "",
+    expires: str = "",
+) -> str:
+    """Create a shareable HTML canvas on gui.now.
+
+    Args:
+        html: Raw HTML content for the canvas
+        markdown: Markdown content (rendered server-side). Use instead of html for text content.
+        title: Optional canvas title
+        expires: Expiry duration: 1h, 24h, 7d, 14d, 30d
+
+    Returns:
+        The shareable canvas URL
+    """
+    client = GuiNowClient()
+    result = client.create(
+        html=html or None,
+        markdown=markdown or None,
+        title=title or None,
+        expires=expires or None,
+    )
+    return f"Canvas created: {result.url} (expires {result.expires_at})"
+
+
+def get_guinow_tool() -> FunctionTool:
+    """Get a LlamaIndex FunctionTool for gui.now canvas creation."""
+    return FunctionTool.from_defaults(
+        fn=_create_canvas,
+        name="create_gui_canvas",
+        description=(
+            "Create a shareable HTML canvas on gui.now. "
+            "Send HTML or Markdown content and get a live URL anyone can view."
+        ),
+    )