Adds --host cli option support (#397)

Co-authored-by: gradio-pr-bot <gradio-pr-bot@users.noreply.github.com>

Author: abidlabs

.changeset/nice-brooms-try.md

@@ -0,0 +1,5 @@
+---
+"trackio": minor
+---
+
+feat:Adds `--host` cli option support

docs/source/launch.md

@@ -96,6 +96,31 @@ trackio.show(color_palette=["#FF0000", "#00FF00", "#0000FF"])
 
 The colors will be cycled through when displaying multiple runs. You can provide as many or as few colors as you like.
 
+## Enabling Remote Access
+
+By default, the dashboard binds to `127.0.0.1` (localhost), which means it can only be accessed from the same machine. To allow remote access from other machines on the network, use the `--host` option:
+
+<hfoptions id="language">
+<hfoption id="Shell">
+
+```sh
+trackio show --host 0.0.0.0
+```
+
+</hfoption>
+<hfoption id="Python">
+
+```py
+import trackio 
+
+trackio.show(host="0.0.0.0")
+```
+
+</hfoption>
+</hfoptions>
+
+This is particularly useful when running Trackio on a remote server or in a containerized environment where you need to access the dashboard from a different machine.
+
 ## Launching a Dashboard in Jupyter Notebooks
 
 You can also launch the dashboard directly within a Jupyter Notebook. Just use the same command as above:

trackio/__init__.py

@@ -477,6 +477,7 @@ def show(
     color_palette: list[str] | None = None,
     open_browser: bool = True,
     block_thread: bool | None = None,
+    host: str | None = None,
 ):
     """
     Launches the Trackio dashboard.
@@ -511,6 +512,9 @@ def show(
             If `True`, the main thread will be blocked until the dashboard is closed.
             If `None` (default behavior), then the main thread will not be blocked if the
             dashboard is launched in a notebook, otherwise the main thread will be blocked.
+        host (`str`, *optional*):
+            The host to bind the server to. If not provided, defaults to `'127.0.0.1'`
+            (localhost only). Set to `'0.0.0.0'` to allow remote access.
 
         Returns:
             `app`: The Gradio app object corresponding to the dashboard launched by Trackio.
@@ -541,6 +545,7 @@ def show(
         mcp_server=_mcp_server,
         theme=theme,
         ssr_mode=False,
+        server_name=host,
     )
 
     base_url = share_url + "/" if share_url else url

trackio/cli.py

@@ -53,6 +53,11 @@ def main():
         required=False,
         help="Comma-separated list of hex color codes for plot lines (e.g. '#FF0000,#00FF00,#0000FF'). If not provided, the TRACKIO_COLOR_PALETTE environment variable will be used, or the default palette if not set.",
     )
+    ui_parser.add_argument(
+        "--host",
+        required=False,
+        help="Host to bind the server to (e.g. '0.0.0.0' for remote access). If not provided, defaults to '127.0.0.1' (localhost only).",
+    )
 
     sync_parser = subparsers.add_parser(
         "sync",
@@ -251,6 +256,7 @@ def main():
             mcp_server=args.mcp_server,
             footer=args.footer,
             color_palette=color_palette,
+            host=args.host,
         )
     elif args.command == "sync":
         sync(