together 2.0.0a13__tar.gz → 2.0.0a15__tar.gz

together-2.0.0a15/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "2.0.0-alpha.15"
+}

{together-2.0.0a13 → together-2.0.0a15}/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 2.0.0-alpha.15 (2026-01-09)
+
+Full Changelog: [v2.0.0-alpha.14...v2.0.0-alpha.15](https://github.com/togethercomputer/together-py/compare/v2.0.0-alpha.14...v2.0.0-alpha.15)
+
+### Features
+
+* Add started_at timestamp to fix time estimation ([92ce60d](https://github.com/togethercomputer/together-py/commit/92ce60dd081700c1ef804dc7ad581a4fcf5d81a0))
+
+
+### Chores
+
+* **api:** Remove APIs that were accidentally added in the wrong namespace ([0425f14](https://github.com/togethercomputer/together-py/commit/0425f14f7598fe3065d6f26c0ae3b577149798b0))
+* Minimize breaking changes on common import paths and alias names ([#206](https://github.com/togethercomputer/together-py/issues/206)) ([e677e60](https://github.com/togethercomputer/together-py/commit/e677e6038ee662d79f9a5f0bbf5452843ea37782))
+* Update README for clusters CLI commands ([aeaf53a](https://github.com/togethercomputer/together-py/commit/aeaf53a4825376d4aad59c9a70efd0b26a3e1aab))
+
+## 2.0.0-alpha.14 (2026-01-06)
+
+Full Changelog: [v2.0.0-alpha.13...v2.0.0-alpha.14](https://github.com/togethercomputer/together-py/compare/v2.0.0-alpha.13...v2.0.0-alpha.14)
+
+### Chores
+
+* Add Instant Clusters to OpenAPI spec ([2583943](https://github.com/togethercomputer/together-py/commit/25839431e9d7636e3cb2e1b14b8eaeeac179dda5))
+
 ## 2.0.0-alpha.13 (2026-01-06)
 
 Full Changelog: [v2.0.0-alpha.12...v2.0.0-alpha.13](https://github.com/togethercomputer/together-py/compare/v2.0.0-alpha.12...v2.0.0-alpha.13)

{together-2.0.0a13 → together-2.0.0a15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: together
-Version: 2.0.0a13
+Version: 2.0.0a15
 Summary: The official Python library for the together API
 Project-URL: Homepage, https://github.com/togethercomputer/together-py
 Project-URL: Repository, https://github.com/togethercomputer/together-py
@@ -232,15 +232,21 @@ from together import Together
 
 client = Together()
 
-dedicated_endpoint = client.endpoints.create(
-    autoscaling={
-        "max_replicas": 5,
-        "min_replicas": 2,
+cluster = client.beta.clusters.create(
+    billing_type="RESERVED",
+    cluster_name="cluster_name",
+    driver_version="CUDA_12_5_555",
+    duration_days=0,
+    gpu_type="H100_SXM",
+    num_gpus=0,
+    region="us-central-8",
+    shared_volume={
+        "region": "region",
+        "size_tib": 0,
+        "volume_name": "volume_name",
     },
-    hardware="1x_nvidia_a100_80gb_sxm",
-    model="meta-llama/Llama-3-8b-chat-hf",
 )
-print(dedicated_endpoint.autoscaling)
+print(cluster.shared_volume)
 ```
 
 The async client uses the exact same interface. If you pass a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance, the file contents will be read asynchronously automatically.
@@ -674,6 +680,47 @@ together models list
 together models upload --model-name my-org/my-model --model-source s3-or-hugging-face
 ```
 
+### Clusters
+
+```bash
+# Help
+together beta clusters --help
+
+# Create a cluster
+together beta clusters create
+
+# List clusters
+together beta clusters list
+
+# Retrieve cluster details
+together beta clusters retrieve [cluster-id]
+
+# Update a cluster
+together beta clusters update [cluster-id]
+
+# Retrieve Together cluster configuration options such as regions, gpu types and drivers available
+together beta clusters list-regions
+```
+
+##### Cluster Storage
+
+```bash
+# Help
+together beta clusters storage --help
+
+# Create cluster storage volume
+together beta clusters storage create
+
+# List storage volumes
+together beta clusters storage list
+
+# Retrieve storage volume
+together beta clusters storage retrieve [storage-id]
+
+# Delete storage volume
+together beta clusters storage delete [storage-id]
+```
+
 ## Contributing
 
 See [the contributing documentation](https://github.com/togethercomputer/together-py/tree/main/./CONTRIBUTING.md).

{together-2.0.0a13 → together-2.0.0a15}/README.md

@@ -186,15 +186,21 @@ from together import Together
 
 client = Together()
 
-dedicated_endpoint = client.endpoints.create(
-    autoscaling={
-        "max_replicas": 5,
-        "min_replicas": 2,
+cluster = client.beta.clusters.create(
+    billing_type="RESERVED",
+    cluster_name="cluster_name",
+    driver_version="CUDA_12_5_555",
+    duration_days=0,
+    gpu_type="H100_SXM",
+    num_gpus=0,
+    region="us-central-8",
+    shared_volume={
+        "region": "region",
+        "size_tib": 0,
+        "volume_name": "volume_name",
     },
-    hardware="1x_nvidia_a100_80gb_sxm",
-    model="meta-llama/Llama-3-8b-chat-hf",
 )
-print(dedicated_endpoint.autoscaling)
+print(cluster.shared_volume)
 ```
 
 The async client uses the exact same interface. If you pass a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance, the file contents will be read asynchronously automatically.
@@ -628,6 +634,47 @@ together models list
 together models upload --model-name my-org/my-model --model-source s3-or-hugging-face
 ```
 
+### Clusters
+
+```bash
+# Help
+together beta clusters --help
+
+# Create a cluster
+together beta clusters create
+
+# List clusters
+together beta clusters list
+
+# Retrieve cluster details
+together beta clusters retrieve [cluster-id]
+
+# Update a cluster
+together beta clusters update [cluster-id]
+
+# Retrieve Together cluster configuration options such as regions, gpu types and drivers available
+together beta clusters list-regions
+```
+
+##### Cluster Storage
+
+```bash
+# Help
+together beta clusters storage --help
+
+# Create cluster storage volume
+together beta clusters storage create
+
+# List storage volumes
+together beta clusters storage list
+
+# Retrieve storage volume
+together beta clusters storage retrieve [storage-id]
+
+# Delete storage volume
+together beta clusters storage delete [storage-id]
+```
+
 ## Contributing
 
 See [the contributing documentation](./CONTRIBUTING.md).

{together-2.0.0a13 → together-2.0.0a15}/api.md

@@ -1,3 +1,50 @@
+# Beta
+
+## Clusters
+
+Types:
+
+```python
+from together.types.beta import (
+    Cluster,
+    ClusterCreateResponse,
+    ClusterUpdateResponse,
+    ClusterListResponse,
+    ClusterDeleteResponse,
+    ClusterListRegionsResponse,
+)
+```
+
+Methods:
+
+- <code title="post /clusters">client.beta.clusters.<a href="./src/together/resources/beta/clusters/clusters.py">create</a>(\*\*<a href="src/together/types/beta/cluster_create_params.py">params</a>) -> <a href="./src/together/types/beta/cluster_create_response.py">ClusterCreateResponse</a></code>
+- <code title="get /clusters/{cluster_id}">client.beta.clusters.<a href="./src/together/resources/beta/clusters/clusters.py">retrieve</a>(cluster_id) -> <a href="./src/together/types/beta/cluster.py">Cluster</a></code>
+- <code title="put /clusters/{cluster_id}">client.beta.clusters.<a href="./src/together/resources/beta/clusters/clusters.py">update</a>(cluster_id, \*\*<a href="src/together/types/beta/cluster_update_params.py">params</a>) -> <a href="./src/together/types/beta/cluster_update_response.py">ClusterUpdateResponse</a></code>
+- <code title="get /clusters">client.beta.clusters.<a href="./src/together/resources/beta/clusters/clusters.py">list</a>() -> <a href="./src/together/types/beta/cluster_list_response.py">ClusterListResponse</a></code>
+- <code title="delete /clusters/{cluster_id}">client.beta.clusters.<a href="./src/together/resources/beta/clusters/clusters.py">delete</a>(cluster_id) -> <a href="./src/together/types/beta/cluster_delete_response.py">ClusterDeleteResponse</a></code>
+- <code title="get /clusters/regions">client.beta.clusters.<a href="./src/together/resources/beta/clusters/clusters.py">list_regions</a>() -> <a href="./src/together/types/beta/cluster_list_regions_response.py">ClusterListRegionsResponse</a></code>
+
+### Storage
+
+Types:
+
+```python
+from together.types.beta.clusters import (
+    ClusterStorage,
+    StorageCreateResponse,
+    StorageListResponse,
+    StorageDeleteResponse,
+)
+```
+
+Methods:
+
+- <code title="post /clusters/storages">client.beta.clusters.storage.<a href="./src/together/resources/beta/clusters/storage.py">create</a>(\*\*<a href="src/together/types/beta/clusters/storage_create_params.py">params</a>) -> <a href="./src/together/types/beta/clusters/storage_create_response.py">StorageCreateResponse</a></code>
+- <code title="get /clusters/storages/{volume_id}">client.beta.clusters.storage.<a href="./src/together/resources/beta/clusters/storage.py">retrieve</a>(volume_id) -> <a href="./src/together/types/beta/clusters/cluster_storage.py">ClusterStorage</a></code>
+- <code title="put /clusters/storages">client.beta.clusters.storage.<a href="./src/together/resources/beta/clusters/storage.py">update</a>(\*\*<a href="src/together/types/beta/clusters/storage_update_params.py">params</a>) -> <a href="./src/together/types/beta/clusters/cluster_storage.py">ClusterStorage</a></code>
+- <code title="get /clusters/storages">client.beta.clusters.storage.<a href="./src/together/resources/beta/clusters/storage.py">list</a>() -> <a href="./src/together/types/beta/clusters/storage_list_response.py">StorageListResponse</a></code>
+- <code title="delete /clusters/storages/{volume_id}">client.beta.clusters.storage.<a href="./src/together/resources/beta/clusters/storage.py">delete</a>(volume_id) -> <a href="./src/together/types/beta/clusters/storage_delete_response.py">StorageDeleteResponse</a></code>
+
 # Chat
 
 ## Completions

{together-2.0.0a13 → together-2.0.0a15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "together"
-version = "2.0.0-alpha.13"
+version = "2.0.0-alpha.15"
 description = "The official Python library for the together API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{together-2.0.0a13 → together-2.0.0a15}/src/together/_client.py

@@ -32,6 +32,7 @@ from ._base_client import (
 
 if TYPE_CHECKING:
     from .resources import (
+        beta,
         chat,
         jobs,
         audio,
@@ -58,6 +59,7 @@ if TYPE_CHECKING:
     from .resources.videos import VideosResource, AsyncVideosResource
     from .resources.batches import BatchesResource, AsyncBatchesResource
     from .resources.hardware import HardwareResource, AsyncHardwareResource
+    from .resources.beta.beta import BetaResource, AsyncBetaResource
     from .resources.chat.chat import ChatResource, AsyncChatResource
     from .resources.endpoints import EndpointsResource, AsyncEndpointsResource
     from .resources.embeddings import EmbeddingsResource, AsyncEmbeddingsResource
@@ -136,6 +138,12 @@ class Together(SyncAPIClient):
 
         self._default_stream_cls = Stream
 
+    @cached_property
+    def beta(self) -> BetaResource:
+        from .resources.beta import BetaResource
+
+        return BetaResource(self)
+
     @cached_property
     def chat(self) -> ChatResource:
         from .resources.chat import ChatResource
@@ -405,6 +413,12 @@ class AsyncTogether(AsyncAPIClient):
 
         self._default_stream_cls = AsyncStream
 
+    @cached_property
+    def beta(self) -> AsyncBetaResource:
+        from .resources.beta import AsyncBetaResource
+
+        return AsyncBetaResource(self)
+
     @cached_property
     def chat(self) -> AsyncChatResource:
         from .resources.chat import AsyncChatResource
@@ -622,6 +636,12 @@ class TogetherWithRawResponse:
     def __init__(self, client: Together) -> None:
         self._client = client
 
+    @cached_property
+    def beta(self) -> beta.BetaResourceWithRawResponse:
+        from .resources.beta import BetaResourceWithRawResponse
+
+        return BetaResourceWithRawResponse(self._client.beta)
+
     @cached_property
     def chat(self) -> chat.ChatResourceWithRawResponse:
         from .resources.chat import ChatResourceWithRawResponse
@@ -725,6 +745,12 @@ class AsyncTogetherWithRawResponse:
     def __init__(self, client: AsyncTogether) -> None:
         self._client = client
 
+    @cached_property
+    def beta(self) -> beta.AsyncBetaResourceWithRawResponse:
+        from .resources.beta import AsyncBetaResourceWithRawResponse
+
+        return AsyncBetaResourceWithRawResponse(self._client.beta)
+
     @cached_property
     def chat(self) -> chat.AsyncChatResourceWithRawResponse:
         from .resources.chat import AsyncChatResourceWithRawResponse
@@ -828,6 +854,12 @@ class TogetherWithStreamedResponse:
     def __init__(self, client: Together) -> None:
         self._client = client
 
+    @cached_property
+    def beta(self) -> beta.BetaResourceWithStreamingResponse:
+        from .resources.beta import BetaResourceWithStreamingResponse
+
+        return BetaResourceWithStreamingResponse(self._client.beta)
+
     @cached_property
     def chat(self) -> chat.ChatResourceWithStreamingResponse:
         from .resources.chat import ChatResourceWithStreamingResponse
@@ -931,6 +963,12 @@ class AsyncTogetherWithStreamedResponse:
     def __init__(self, client: AsyncTogether) -> None:
         self._client = client
 
+    @cached_property
+    def beta(self) -> beta.AsyncBetaResourceWithStreamingResponse:
+        from .resources.beta import AsyncBetaResourceWithStreamingResponse
+
+        return AsyncBetaResourceWithStreamingResponse(self._client.beta)
+
     @cached_property
     def chat(self) -> chat.AsyncChatResourceWithStreamingResponse:
         from .resources.chat import AsyncChatResourceWithStreamingResponse

{together-2.0.0a13 → together-2.0.0a15}/src/together/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "together"
-__version__ = "2.0.0-alpha.13"  # x-release-please-version
+__version__ = "2.0.0-alpha.15"  # x-release-please-version

together-2.0.0a15/src/together/constants.py

@@ -0,0 +1,34 @@
+# Manually added to minimize breaking changes from V1
+from ._constants import (
+    MAX_RETRY_DELAY as MAX_RETRY_DELAY,
+    DEFAULT_MAX_RETRIES,
+    INITIAL_RETRY_DELAY as INITIAL_RETRY_DELAY,
+)
+from .lib.constants import (
+    MIN_SAMPLES as MIN_SAMPLES,
+    DISABLE_TQDM as DISABLE_TQDM,
+    MAX_IMAGE_BYTES as MAX_IMAGE_BYTES,
+    NUM_BYTES_IN_GB as NUM_BYTES_IN_GB,
+    MAX_FILE_SIZE_GB as MAX_FILE_SIZE_GB,
+    MIN_PART_SIZE_MB as MIN_PART_SIZE_MB,
+    DOWNLOAD_BLOCK_SIZE as DOWNLOAD_BLOCK_SIZE,
+    MAX_MULTIPART_PARTS as MAX_MULTIPART_PARTS,
+    TARGET_PART_SIZE_MB as TARGET_PART_SIZE_MB,
+    MAX_CONCURRENT_PARTS as MAX_CONCURRENT_PARTS,
+    MAX_IMAGES_PER_EXAMPLE as MAX_IMAGES_PER_EXAMPLE,
+    MULTIPART_THRESHOLD_GB as MULTIPART_THRESHOLD_GB,
+    MAX_BASE64_IMAGE_LENGTH as MAX_BASE64_IMAGE_LENGTH,
+    MULTIPART_UPLOAD_TIMEOUT as MULTIPART_UPLOAD_TIMEOUT,
+    PARQUET_EXPECTED_COLUMNS as PARQUET_EXPECTED_COLUMNS,
+    REQUIRED_COLUMNS_MESSAGE as REQUIRED_COLUMNS_MESSAGE,
+    JSONL_REQUIRED_COLUMNS_MAP as JSONL_REQUIRED_COLUMNS_MAP,
+    POSSIBLE_ROLES_CONVERSATION as POSSIBLE_ROLES_CONVERSATION,
+    DatasetFormat as DatasetFormat,
+)
+
+TIMEOUT_SECS = 600
+MAX_SESSION_LIFETIME_SECS = 180
+MAX_CONNECTION_RETRIES = 2
+MAX_RETRIES = DEFAULT_MAX_RETRIES
+
+BASE_URL = "https://api.together.xyz/v1"

together-2.0.0a15/src/together/error.py

@@ -0,0 +1,16 @@
+
+# Manually added to minimize breaking changes from V1
+from ._exceptions import (
+    APIError as APIError,
+    RateLimitError as RateLimitError,
+    APITimeoutError,
+    BadRequestError,
+    APIConnectionError as APIConnectionError,
+    AuthenticationError as AuthenticationError,
+    APIResponseValidationError,
+)
+
+Timeout = APITimeoutError
+InvalidRequestError = BadRequestError
+TogetherException = APIError
+ResponseError = APIResponseValidationError

together-2.0.0a15/src/together/lib/cli/api/beta/beta.py

@@ -0,0 +1,12 @@
+import click
+
+from together.lib.cli.api.beta.clusters import clusters
+
+
+@click.group()
+def beta() -> None:
+    """Beta API commands"""
+    pass
+
+
+beta.add_command(clusters)