add deprecation notices

Author: zainhas

README.md

@@ -4,7 +4,21 @@
   </a>
 </div>
 
-# Together Python API library
+> [!CAUTION]
+> ## ⚠️ DEPRECATION NOTICE
+>
+> **This package (`together`) is deprecated and will no longer be maintained after January 2026.**
+>
+> Please migrate to the new SDK: **[together-ai](https://github.com/togethercomputer/together-py)**
+>
+> 📖 **Migration Guide:** [https://docs.together.ai/docs/pythonv2-migration-guide](https://docs.together.ai/docs/pythonv2-migration-guide)
+>
+> ```bash
+> pip uninstall together
+> pip install together-ai
+> ```
+
+# Together Python API library (DEPRECATED)
 
 [![PyPI version](https://img.shields.io/pypi/v/together.svg)](https://pypi.org/project/together/)
 [![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/9Rk6sSeWEG?style=flat&theme=discord-inverted)](https://discord.com/invite/9Rk6sSeWEG)

pyproject.toml

@@ -14,10 +14,11 @@ build-backend = "poetry.masonry.api"
 name = "together"
 version = "1.5.31"
 authors = ["Together AI <support@together.ai>"]
-description = "Python client for Together's Cloud Platform!"
+description = "[DEPRECATED - Use together-py instead] Python client for Together's Cloud Platform. See https://github.com/togethercomputer/together-py for the new SDK."
 readme = "README.md"
 license = "Apache-2.0"
 classifiers = [
+    "Development Status :: 7 - Inactive",
     "Programming Language :: Python :: 3",
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: POSIX :: Linux",

src/together/__init__.py

@@ -1,5 +1,62 @@
 from __future__ import annotations
 
+import os
+import sys
+import warnings
+
+# =============================================================================
+# DEPRECATION NOTICE
+# =============================================================================
+_DEPRECATION_MESSAGE = """
+================================================================================
+DEPRECATION WARNING: The 'together' package is deprecated and will no longer
+be maintained after January 2026.
+
+Please migrate to the new SDK: https://github.com/togethercomputer/together-py
+
+Migration guide: https://docs.together.ai/docs/pythonv2-migration-guide
+================================================================================
+"""
+
+# Show deprecation warning (visible to developers with warnings enabled)
+warnings.warn(
+    "The 'together' package is deprecated and will no longer be maintained after "
+    "January 2026. Please migrate to the new SDK: "
+    "https://github.com/togethercomputer/together-py "
+    "Migration guide: https://docs.together.ai/docs/pythonv2-migration-guide",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Also print a visible notice to stderr (unless suppressed)
+if not os.environ.get("TOGETHER_SUPPRESS_DEPRECATION_WARNING"):
+    try:
+        from rich.console import Console
+        from rich.panel import Panel
+
+        console = Console(stderr=True)
+        console.print(
+            Panel(
+                "[bold yellow]DEPRECATION WARNING[/bold yellow]\n\n"
+                "The [cyan]together[/cyan] package is deprecated and will no longer "
+                "be maintained after [bold]January 2026[/bold].\n\n"
+                "Please migrate to the new SDK:\n"
+                "[link=https://github.com/togethercomputer/together-py]"
+                "https://github.com/togethercomputer/together-py[/link]\n\n"
+                "Migration guide:\n"
+                "[link=https://docs.together.ai/docs/pythonv2-migration-guide]"
+                "https://docs.together.ai/docs/pythonv2-migration-guide[/link]\n\n"
+                "[dim]Set TOGETHER_SUPPRESS_DEPRECATION_WARNING=1 to hide this message.[/dim]",
+                title="⚠️  Deprecation Notice",
+                border_style="yellow",
+            )
+        )
+    except ImportError:
+        # Fallback if rich is not available
+        print(_DEPRECATION_MESSAGE, file=sys.stderr)
+
+# =============================================================================
+
 from contextvars import ContextVar
 from typing import TYPE_CHECKING, Callable