langhost 0.11.1__py3-none-any.whl

langhost/__init__.py

@@ -0,0 +1,10 @@
+"""Minimal CLI for self-hosted LangGraph Agent Server (edition=pg)."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("langhost")
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "0.0.0"
+
+__all__ = ["__version__"]

langhost/__main__.py

@@ -0,0 +1,4 @@
+from langhost.cli import cli
+
+if __name__ == "__main__":
+    cli()

langhost/cli.py

@@ -0,0 +1,357 @@
+"""langhost CLI — thin wrappers around langgraph-cli + langgraph_api.cli.run_server."""
+
+from __future__ import annotations
+
+import logging
+import os
+import pathlib
+import sys
+from collections.abc import Sequence
+from typing import Any
+
+import click
+from dotenv import load_dotenv
+from langgraph_api.cli import run_server
+from langgraph_cli.config import validate_config_file
+from langgraph_cli.constants import DEFAULT_CONFIG
+from pyfiglet import figlet_format
+
+from langhost import __version__
+
+# Always the open Postgres+Redis runtime.
+RUNTIME_EDITION = "pg"
+DEFAULT_PORT = 31296
+LOG_LEVELS = ["CRITICAL", "ERROR", "WARNING", "INFO", "DEBUG"]
+DEFAULT_STUDIO_ORIGIN = "https://smith.langchain.com"
+
+# Upstream run_server always logs an inmem-oriented welcome; replace it for langhost.
+_UPSTREAM_WELCOME_MARKER = "This in-memory server is designed for development and testing"
+
+
+def _display_host(host: str) -> str:
+    if host in {"0.0.0.0", "::"}:
+        return "127.0.0.1"
+    if ":" in host and not host.startswith("["):
+        return f"[{host}]"
+    return host
+
+
+def _server_base_url(
+    host: str,
+    port: int,
+    *,
+    ssl: bool,
+    mount_prefix: str | None,
+) -> str:
+    scheme = "https" if ssl else "http"
+    url = f"{scheme}://{_display_host(host)}:{port}"
+    if mount_prefix:
+        url += mount_prefix
+    return url
+
+
+def _langhost_welcome(
+    *,
+    host: str,
+    port: int,
+    ssl: bool,
+    studio_origin: str | None,
+    mount_prefix: str | None,
+) -> str:
+    api_url = _server_base_url(host, port, ssl=ssl, mount_prefix=mount_prefix)
+    origin = (studio_origin or DEFAULT_STUDIO_ORIGIN).rstrip("/")
+    studio_url = f"{origin}/studio/?baseUrl={api_url}"
+    agent_chat_url = f"https://agentchat.vercel.app/?apiUrl={api_url}&assistantId=agent"
+    title = figlet_format("langhost", font="standard").rstrip()
+    return f"""
+
+{title}
+
+- 🚀 API: \033[36m{api_url}\033[0m
+- 🎨 Studio UI: \033[36m{studio_url}\033[0m
+- 📚 API Docs: \033[36m{api_url}/docs\033[0m
+- 💬 Agent Chat UI: \033[36m{agent_chat_url}\033[0m
+
+Self-hosted, production-grade LangGraph Agent Server (Postgres + Redis).
+langhost {__version__}
+
+"""
+
+
+class _ReplaceWelcomeBanner(logging.Filter):
+    """Swap the upstream inmem welcome for a prebuilt langhost banner."""
+
+    def __init__(self, welcome: str) -> None:
+        super().__init__()
+        self._welcome = welcome
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        if _UPSTREAM_WELCOME_MARKER not in record.getMessage():
+            return True
+        record.msg = self._welcome
+        record.args = ()
+        return True
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="langhost")
+def cli() -> None:
+    """Self-hosted LangGraph Agent Server on Postgres + Redis (edition=pg)."""
+
+
+@cli.command(
+    "serve",
+    help=(
+        "Run the Agent Server (LANGGRAPH_RUNTIME_EDITION=pg). "
+        "Use --reload for local development; --workers for production."
+    ),
+)
+@click.option(
+    "--host",
+    default="127.0.0.1",
+    show_default=True,
+    help=(
+        "Bind address. Prefer 127.0.0.1 for local work; use 0.0.0.0 only on "
+        "trusted networks / behind a reverse proxy."
+    ),
+)
+@click.option(
+    "--port",
+    "-p",
+    default=DEFAULT_PORT,
+    show_default=True,
+    type=int,
+    help="Port to bind the Agent Server to.",
+)
+@click.option(
+    "--config",
+    "-c",
+    default=DEFAULT_CONFIG,
+    show_default=True,
+    type=click.Path(exists=True, dir_okay=False, path_type=pathlib.Path),
+    help="Path to langgraph.json (graphs, deps, env, auth, http, …).",
+)
+@click.option(
+    "--env-file",
+    type=click.Path(exists=True, dir_okay=False, path_type=pathlib.Path),
+    default=None,
+    help="Optional dotenv file to load before starting (default: .env if present).",
+)
+@click.option(
+    "--database-uri",
+    default=None,
+    help="Postgres URI (overrides DATABASE_URI). Required unless set in the environment.",
+)
+@click.option(
+    "--redis-uri",
+    default=None,
+    help="Redis URI (overrides REDIS_URI). Required unless set in the environment.",
+)
+@click.option(
+    "--reload",
+    is_flag=True,
+    help="Auto-reload on code changes (dev). Incompatible with --workers > 1.",
+)
+@click.option(
+    "--reload-include",
+    "reload_includes",
+    multiple=True,
+    help="Glob(s) to watch when --reload is set (repeatable).",
+)
+@click.option(
+    "--reload-exclude",
+    "reload_excludes",
+    multiple=True,
+    help="Glob(s) to ignore when --reload is set (repeatable).",
+)
+@click.option(
+    "--workers",
+    default=1,
+    show_default=True,
+    type=click.IntRange(min=1),
+    help="Uvicorn worker processes (prod). Incompatible with --reload.",
+)
+@click.option(
+    "--n-jobs-per-worker",
+    default=None,
+    type=int,
+    help=(
+        "Max concurrent background jobs per server process "
+        "(sets N_JOBS_PER_WORKER; default inside run_server is 1)."
+    ),
+)
+@click.option(
+    "--browser/--no-browser",
+    default=False,
+    help="Open LangSmith Studio in the browser when the server is ready.",
+)
+@click.option(
+    "--studio-url",
+    default=None,
+    help="LangSmith Studio base URL (default: https://smith.langchain.com).",
+)
+@click.option(
+    "--tunnel",
+    is_flag=True,
+    help="Expose the server via a Cloudflare tunnel (remote Studio access).",
+)
+@click.option(
+    "--debug-port",
+    default=None,
+    type=int,
+    help="Listen for a remote debugger (debugpy) on this port.",
+)
+@click.option(
+    "--wait-for-client",
+    is_flag=True,
+    help="With --debug-port, block until a debugger attaches.",
+)
+@click.option(
+    "--allow-blocking",
+    is_flag=True,
+    help="Do not raise on synchronous/blocking I/O in graph code.",
+)
+@click.option(
+    "--server-log-level",
+    default="INFO",
+    show_default=True,
+    type=click.Choice(LOG_LEVELS, case_sensitive=False),
+    help="Log level for uvicorn / langgraph_api.server.",
+)
+@click.option(
+    "--ssl-certfile",
+    type=click.Path(exists=True, dir_okay=False, path_type=pathlib.Path),
+    default=None,
+    help="TLS certificate file (serve over HTTPS).",
+)
+@click.option(
+    "--ssl-keyfile",
+    type=click.Path(exists=True, dir_okay=False, path_type=pathlib.Path),
+    default=None,
+    help="TLS private key file (serve over HTTPS).",
+)
+def serve(
+    host: str,
+    port: int,
+    config: pathlib.Path,
+    env_file: pathlib.Path | None,
+    database_uri: str | None,
+    redis_uri: str | None,
+    reload: bool,
+    reload_includes: tuple[str, ...],
+    reload_excludes: tuple[str, ...],
+    workers: int,
+    n_jobs_per_worker: int | None,
+    browser: bool,
+    studio_url: str | None,
+    tunnel: bool,
+    debug_port: int | None,
+    wait_for_client: bool,
+    allow_blocking: bool,
+    server_log_level: str,
+    ssl_certfile: pathlib.Path | None,
+    ssl_keyfile: pathlib.Path | None,
+) -> None:
+    if reload and workers > 1:
+        raise click.UsageError("Cannot combine --reload with --workers > 1.")
+    if (ssl_certfile is None) != (ssl_keyfile is None):
+        raise click.UsageError("Both --ssl-certfile and --ssl-keyfile are required for HTTPS.")
+    if ssl_certfile and ssl_keyfile and tunnel:
+        raise click.UsageError("Cannot combine --tunnel with SSL options.")
+    if wait_for_client and debug_port is None:
+        raise click.UsageError("--wait-for-client requires --debug-port.")
+
+    load_dotenv(env_file or ".env", override=False)
+    os.environ["LANGGRAPH_RUNTIME_EDITION"] = RUNTIME_EDITION
+
+    database_uri = database_uri or os.environ.get("DATABASE_URI")
+    redis_uri = redis_uri or os.environ.get("REDIS_URI")
+    if not database_uri:
+        raise click.UsageError(
+            "DATABASE_URI is required. Please set it in the environment or pass it to the command via --database-uri."
+        )
+    if not redis_uri:
+        raise click.UsageError(
+            "REDIS_URI is required. Please set it in the environment or pass it to the command via --redis-uri."
+        )
+    if n_jobs_per_worker is None:
+        raw = os.environ.get("N_JOBS_PER_WORKER")
+        if raw:
+            n_jobs_per_worker = int(raw)
+
+    config_json = validate_config_file(config)
+    if config_json.get("node_version"):
+        raise click.UsageError(
+            "JS graphs are not supported by langhost. Remove the 'node_version' field from the config."
+        )
+
+    cwd = pathlib.Path.cwd()
+    sys.path.append(str(cwd))
+    for dep in config_json.get("dependencies", []):
+        dep_path = cwd / dep
+        if dep_path.is_dir() and dep_path.exists():
+            sys.path.append(str(dep_path))
+
+    includes: Sequence[str] | None = list(reload_includes) or None
+    excludes: Sequence[str] | None = list(reload_excludes) or None
+    uvicorn_kwargs: dict[str, Any] = {}
+    if workers > 1:
+        uvicorn_kwargs["workers"] = workers
+
+    http_cfg = config_json.get("http")
+    mount_prefix = None
+    if isinstance(http_cfg, dict):
+        mount_prefix = http_cfg.get("mount_prefix")
+    mount_prefix = (
+        os.environ.get("MOUNT_PREFIX") or os.environ.get("LANGGRAPH_MOUNT_PREFIX") or mount_prefix
+    )
+
+    welcome = _langhost_welcome(
+        host=host,
+        port=port,
+        ssl=ssl_certfile is not None and ssl_keyfile is not None,
+        studio_origin=studio_url,
+        mount_prefix=mount_prefix,
+    )
+    api_cli_logger = logging.getLogger("langgraph_api.cli")
+    banner_filter = _ReplaceWelcomeBanner(welcome)
+    api_cli_logger.addFilter(banner_filter)
+    try:
+        run_server(
+            host,
+            port,
+            reload,
+            config_json.get("graphs", {}),
+            n_jobs_per_worker=n_jobs_per_worker,
+            open_browser=browser,
+            tunnel=tunnel,
+            debug_port=debug_port,
+            wait_for_client=wait_for_client,
+            env=config_json.get("env"),
+            reload_includes=includes,
+            reload_excludes=excludes,
+            store=config_json.get("store"),
+            auth=config_json.get("auth"),
+            http=http_cfg,
+            ui=config_json.get("ui"),
+            ui_config=config_json.get("ui_config"),
+            webhooks=config_json.get("webhooks"),
+            checkpointer=config_json.get("checkpointer"),
+            studio_url=studio_url,
+            disable_persistence=config_json.get("disable_persistence", False),
+            allow_blocking=allow_blocking,
+            server_level=server_log_level,
+            ssl_certfile=ssl_certfile,
+            ssl_keyfile=ssl_keyfile,
+            runtime_edition=RUNTIME_EDITION,
+            __database_uri__=database_uri,
+            __redis_uri__=redis_uri,
+            __migrations_path__=None,
+            **uvicorn_kwargs,
+        )
+    finally:
+        api_cli_logger.removeFilter(banner_filter)
+
+
+if __name__ == "__main__":
+    cli()

langhost-0.11.1.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: langhost
+Version: 0.11.1
+Summary: Minimal CLI for self-hosted LangGraph Agent Server on langgraph-runtime-pg
+Project-URL: Homepage, https://github.com/langhost/langhost
+Project-URL: Repository, https://github.com/langhost/langhost
+Project-URL: Issues, https://github.com/langhost/langhost/issues
+Project-URL: Changelog, https://github.com/langhost/langhost/releases
+Author-email: Mohankumar Ramachandran <mail@mohanram.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent-protocol,agent-server,agents,ai-agents,cli,langchain,langgraph,langgraph-api,langgraph-sdk,langsmith,llm,open-source,postgres,redis,self-hosted,uvicorn
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1.7
+Requires-Dist: langgraph-cli<0.5,>=0.4.0
+Requires-Dist: langgraph-runtime-pg==0.11.1
+Requires-Dist: pyfiglet>=1.0.0
+Requires-Dist: python-dotenv>=0.8.0
+Requires-Dist: uvicorn[standard]>=0.51.0
+Description-Content-Type: text/markdown
+
+# langhost
+
+Minimal CLI for running the official LangGraph Agent Server on the open
+[`langgraph-runtime-pg`](https://pypi.org/project/langgraph-runtime-pg/) backend
+(Postgres + Redis).
+
+## Command
+
+```bash
+langhost serve [OPTIONS]
+```
+
+Requires a `langgraph.json` in the working directory (same format as
+[`langgraph-cli`](https://github.com/langchain-ai/langgraph/tree/main/libs/cli))
+and `DATABASE_URI` / `REDIS_URI` (see repo `.env.example`). Bring your own
+Postgres + Redis (for example via the repo `docker-compose.yml`).
+
+```bash
+cp .env.example .env
+docker compose up -d postgres redis
+
+# Dev (hot reload)
+langhost serve --reload -c langgraph.json
+
+# Prod (multi-process)
+langhost serve --host 0.0.0.0 --workers 4 -c langgraph.json
+```
+
+Run `langhost serve --help` for the full option list.

langhost-0.11.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+langhost/__init__.py,sha256=sikKdH4Ndot6yowFCsnKy_umgW6qiG1aIZWn8gPbVyc,279
+langhost/__main__.py,sha256=Z_8g0qzCSaEiYYX5KPZ_0Q3YHN83PaSNYPW1op38meM,67
+langhost/cli.py,sha256=5-hiDEddirPsj_Pzoy8avojtUWRk3DcwxrO8figUWbY,10774
+langhost-0.11.1.dist-info/METADATA,sha256=GuzF3kUYJ2C25yybDrn59sxwZzynmeapmYFSd-0VHJ4,2442
+langhost-0.11.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+langhost-0.11.1.dist-info/entry_points.txt,sha256=dYV6IfsUZmU1pCBJPoEszZzU76O1uYMd_mjpQNjW_KE,46
+langhost-0.11.1.dist-info/licenses/LICENSE,sha256=VOzjTuqsyEVtwd7ylP1eoLjPAAvdB6iC9a7JBGFJUgE,1080
+langhost-0.11.1.dist-info/RECORD,,

langhost-0.11.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

langhost-0.11.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+langhost = langhost.cli:cli

langhost-0.11.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohankumar Ramachandran
+
+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.