add deprecation notices (#404)

* add deprecation notices

* update toml

* info instead of warning

* wip

Author: zainhas

README.md

@@ -4,6 +4,34 @@
   </a>
 </div>
 
+> [!NOTE]
+> ## 🚀 Together Python SDK 2.0 is now available!
+>
+> Check out the new SDK: **[together-py](https://github.com/togethercomputer/together-py)**
+>
+> 📖 **Migration Guide:** [https://docs.together.ai/docs/pythonv2-migration-guide](https://docs.together.ai/docs/pythonv2-migration-guide)
+>
+> ### Install the Beta
+>
+> **Using uv (Recommended):**
+> ```bash
+> # Install uv if you haven't already
+> curl -LsSf https://astral.sh/uv/install.sh | sh
+>
+> # Install together python SDK
+> uv add together --prerelease allow
+>
+> # Or upgrade an existing installation
+> uv sync --upgrade-package together --prerelease allow
+> ```
+>
+> **Using pip:**
+> ```bash
+> pip install --pre together
+> ```
+>
+> This package will be maintained until January 2026.
+
 # Together Python API library
 
 [![PyPI version](https://img.shields.io/pypi/v/together.svg)](https://pypi.org/project/together/)

pyproject.toml

@@ -14,7 +14,7 @@ build-backend = "poetry.masonry.api"
 name = "together"
 version = "1.5.31"
 authors = ["Together AI <[email protected]>"]
-description = "Python client for Together's Cloud Platform!"
+description = "Python client for Together's Cloud Platform! Note: SDK 2.0 is now available at https://github.com/togethercomputer/together-py"
 readme = "README.md"
 license = "Apache-2.0"
 classifiers = [

src/together/__init__.py

@@ -1,5 +1,56 @@
 from __future__ import annotations
 
+import os
+import sys
+
+# =============================================================================
+# SDK 2.0 ANNOUNCEMENT
+# =============================================================================
+_ANNOUNCEMENT_MESSAGE = """
+================================================================================
+Together Python SDK 2.0 is now available!
+
+Install: pip install --pre together
+New SDK: https://github.com/togethercomputer/together-py
+Migration guide: https://docs.together.ai/docs/pythonv2-migration-guide
+
+This package will be maintained until January 2026.
+================================================================================
+"""
+
+# Show info banner (unless suppressed)
+if not os.environ.get("TOGETHER_NO_BANNER"):
+    try:
+        from rich.console import Console
+        from rich.panel import Panel
+
+        console = Console(stderr=True)
+        console.print(
+            Panel(
+                "[bold cyan]Together Python SDK 2.0 is now available![/bold cyan]\n\n"
+                "Install the beta:\n"
+                "[green]pip install --pre together[/green]  or  "
+                "[green]uv add together --prerelease allow[/green]\n\n"
+                "New SDK: [link=https://github.com/togethercomputer/together-py]"
+                "https://github.com/togethercomputer/together-py[/link]\n"
+                "Migration guide: [link=https://docs.together.ai/docs/pythonv2-migration-guide]"
+                "https://docs.together.ai/docs/pythonv2-migration-guide[/link]\n\n"
+                "[dim]This package will be maintained until January 2026.\n"
+                "Set TOGETHER_NO_BANNER=1 to hide this message.[/dim]",
+                title="🚀 New SDK Available",
+                border_style="cyan",
+            )
+        )
+    except Exception:
+        # Fallback for any error (ImportError, OSError in daemons, rich errors, etc.)
+        # Banner display should never break module imports
+        try:
+            print(_ANNOUNCEMENT_MESSAGE, file=sys.stderr)
+        except Exception:
+            pass  # Silently ignore if even stderr is unavailable
+
+# =============================================================================
+
 from contextvars import ContextVar
 from typing import TYPE_CHECKING, Callable