together 2.0.0a14__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.0a14 → together-2.0.0a15}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 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)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: together
-Version: 2.0.0a14
+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
@@ -680,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.0a14 → together-2.0.0a15}/README.md

@@ -634,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.0a14 → together-2.0.0a15}/pyproject.toml

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

{together-2.0.0a14 → 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.14"  # 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.0a14 → together-2.0.0a15}/src/together/lib/cli/api/utils.py

@@ -104,11 +104,11 @@ def generate_progress_bar(
     progress = "Progress: [bold red]unavailable[/bold red]"
     if finetune_job.status in COMPLETED_STATUSES:
         progress = "Progress: [bold green]completed[/bold green]"
-    elif finetune_job.updated_at is not None:
-        update_at = finetune_job.updated_at.astimezone()
+    elif getattr(finetune_job, "started_at", None) is not None and isinstance(finetune_job.started_at, datetime):
+        started_at = finetune_job.started_at.astimezone()
 
         if finetune_job.progress is not None:
-            if current_time < update_at:
+            if current_time < started_at:
                 return progress
 
             if not finetune_job.progress.estimate_available:
@@ -117,7 +117,7 @@ def generate_progress_bar(
             if finetune_job.progress.seconds_remaining <= 0:
                 return progress
 
-            elapsed_time = (current_time - update_at).total_seconds()
+            elapsed_time = (current_time - started_at).total_seconds()
             ratio_filled = min(elapsed_time / finetune_job.progress.seconds_remaining, 1.0)
             percentage = ratio_filled * 100
             filled = math.ceil(ratio_filled * _PROGRESS_BAR_WIDTH)

{together-2.0.0a14 → together-2.0.0a15}/src/together/lib/types/fine_tuning.py

@@ -305,6 +305,9 @@ class FinetuneResponse(BaseModel):
     updated_at: datetime
     """Last update timestamp of the fine-tune job"""
 
+    started_at: Optional[datetime] = None
+    """Start timestamp of a current stage of the fine-tune job"""
+
     batch_size: Optional[int] = None
     """Batch size used for training"""
 

{together-2.0.0a14 → together-2.0.0a15}/src/together/types/__init__.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from __future__ import annotations
+from __future__ import annotations # noqa
 
 from .batch_job import BatchJob as BatchJob
 from .embedding import Embedding as Embedding
@@ -68,3 +68,14 @@ from .fine_tuning_estimate_price_response import FineTuningEstimatePriceResponse
 from .fine_tuning_list_checkpoints_response import (
     FineTuningListCheckpointsResponse as FineTuningListCheckpointsResponse,
 )
+
+# Manually added to minimize breaking changes from V1
+from .chat.chat_completion import ChatCompletion 
+from .chat.chat_completion_chunk import ChatCompletionChunk as ChatCompletionChunk
+from .chat.chat_completion_usage import ChatCompletionUsage
+UsageData = ChatCompletionUsage
+ChatCompletionResponse = ChatCompletion
+CompletionResponse = Completion
+ListEndpoint = EndpointListResponse
+ImageRequest = ImageGenerateParams
+ImageResponse = ImageFile

together-2.0.0a15/src/together/types/chat_completions.py

@@ -0,0 +1,7 @@
+# Manually added to minimize breaking changes from V1
+from .tool_choice import ToolChoice
+from .chat.chat_completion import ChatCompletion
+from .chat.chat_completion_chunk import ChatCompletionChunk as ChatCompletionChunk
+
+ChatCompletionResponse = ChatCompletion
+ToolCalls = ToolChoice

together-2.0.0a15/src/together/types/endpoints.py

@@ -0,0 +1,4 @@
+# Manually added to minimize breaking changes from V1
+from together.types import DedicatedEndpoint as DedicatedEndpoint
+
+ListEndpoint = DedicatedEndpoint

together-2.0.0a15/src/together/types/files.py

@@ -0,0 +1,8 @@
+# Manually added to minimize breaking changes from V1
+from . import (
+    FileList as FileList,
+    FileType as FileType,
+    FilePurpose as FilePurpose,
+    FileResponse as FileResponse,
+    FileDeleteResponse as FileDeleteResponse,
+)

{together-2.0.0a14 → together-2.0.0a15}/src/together/types/fine_tuning_cancel_response.py

@@ -177,6 +177,9 @@ class FineTuningCancelResponse(BaseModel):
     progress: Optional[Progress] = None
     """Progress information for the fine-tuning job"""
 
+    started_at: Optional[datetime] = None
+    """Start timestamp of the current stage of the fine-tune job"""
+
     suffix: Optional[str] = None
     """Suffix added to the fine-tuned model name"""
 

{together-2.0.0a14 → together-2.0.0a15}/src/together/types/fine_tuning_list_response.py

@@ -178,6 +178,9 @@ class Data(BaseModel):
     progress: Optional[DataProgress] = None
     """Progress information for the fine-tuning job"""
 
+    started_at: Optional[datetime] = None
+    """Start timestamp of the current stage of the fine-tune job"""
+
     suffix: Optional[str] = None
     """Suffix added to the fine-tuned model name"""
 

together-2.0.0a15/src/together/types/finetune.py

@@ -0,0 +1,27 @@
+# Manually added to minimize breaking changes from V1
+from ..lib.types.fine_tuning import (
+    COMPLETED_STATUSES as COMPLETED_STATUSES,
+    TrainingType as TrainingType,
+    FinetuneEvent as FinetuneEvent,
+    TrainingMethod as TrainingMethod,
+    FinetuneRequest as FinetuneRequest,
+    EmptyLRScheduler as EmptyLRScheduler,
+    FinetuneProgress as FinetuneProgress,
+    FinetuneResponse as FinetuneResponse,
+    FullTrainingType as FullTrainingType,
+    LoRATrainingType as LoRATrainingType,
+    CosineLRScheduler as CosineLRScheduler,
+    FinetuneEventType as FinetuneEventType,
+    FinetuneJobStatus as FinetuneJobStatus,
+    LinearLRScheduler as LinearLRScheduler,
+    TrainingMethodDPO as TrainingMethodDPO,
+    TrainingMethodSFT as TrainingMethodSFT,
+    FinetuneEventLevels as FinetuneEventLevels,
+    FinetuneLRScheduler as FinetuneLRScheduler,
+    CosineLRSchedulerArgs as CosineLRSchedulerArgs,
+    LinearLRSchedulerArgs as LinearLRSchedulerArgs,
+    FinetuneTrainingLimits as FinetuneTrainingLimits,
+    FinetuneMultimodalParams as FinetuneMultimodalParams,
+    FinetuneFullTrainingLimits as FinetuneFullTrainingLimits,
+    FinetuneLoraTrainingLimits as FinetuneLoraTrainingLimits,
+)

{together-2.0.0a14 → together-2.0.0a15}/src/together/types/finetune_response.py

@@ -174,6 +174,8 @@ class FinetuneResponse(BaseModel):
 
     queue_depth: Optional[int] = None
 
+    started_at: Optional[datetime] = None
+
     token_count: Optional[int] = None
 
     total_price: Optional[int] = None

together-2.0.0a15/src/together/types/models.py

@@ -0,0 +1,2 @@
+# Manually added to minimize breaking changes from V1
+from together.types import ModelObject as ModelObject

{together-2.0.0a14 → together-2.0.0a15}/tests/test_cli_utils.py

@@ -14,7 +14,7 @@ from together.lib.types.fine_tuning import (
 
 def create_finetune_response(
     status: FinetuneJobStatus = FinetuneJobStatus.STATUS_RUNNING,
-    updated_at: datetime = datetime(2024, 1, 1, 12, 0, 0, tzinfo=timezone.utc),
+    started_at: datetime = datetime(2024, 1, 1, 12, 0, 0, tzinfo=timezone.utc),
     progress: Union[FinetuneProgress, None] = None,
     job_id: str = "ft-test-123",
 ) -> FinetuneResponse:
@@ -32,7 +32,8 @@ def create_finetune_response(
     return FinetuneResponse(
         id=job_id,
         progress=progress,
-        updated_at=updated_at,
+        updated_at=started_at, # to calm down mypy
+        started_at=started_at,
         status=status,
         created_at=datetime(2024, 1, 1, 12, 0, 0, tzinfo=timezone.utc),
         model_output_name="test_model",
@@ -333,7 +334,7 @@ class TestGenerateProgressBarCornerCases:
         """Test with different timezone for updated_at."""
         current_time = datetime(2024, 1, 1, 12, 0, 30, tzinfo=timezone.utc)
         finetune_job = create_finetune_response(
-            updated_at=datetime(2024, 1, 1, 7, 0, 0, tzinfo=ZoneInfo("EST")),  # Same as 12:00:00 UTC (EST = UTC-5)
+            started_at=datetime(2024, 1, 1, 7, 0, 0, tzinfo=ZoneInfo("EST")),  # Same as 12:00:00 UTC (EST = UTC-5)
             progress=FinetuneProgress(estimate_available=True, seconds_remaining=60.0),
         )
 
@@ -358,7 +359,7 @@ class TestGenerateProgressBarCornerCases:
         """Test unusual case where current time appears before updated_at."""
         current_time = datetime(2024, 1, 1, 12, 0, 0, tzinfo=timezone.utc)
         finetune_job = create_finetune_response(
-            updated_at=datetime(2024, 1, 1, 12, 0, 30, tzinfo=timezone.utc),  # In the "future"
+            started_at=datetime(2024, 1, 1, 12, 0, 30, tzinfo=timezone.utc),  # In the "future"
             progress=FinetuneProgress(estimate_available=True, seconds_remaining=100.0),
         )
 

{together-2.0.0a14 → together-2.0.0a15}/uv.lock

@@ -1963,7 +1963,7 @@ wheels = [
 
 [[package]]
 name = "together"
-version = "2.0.0a11"
+version = "2.0.0a14"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

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

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