together 2.0.0a6__tar.gz → 2.0.0a8__tar.gz

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

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

{together-2.0.0a6 → together-2.0.0a8}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 2.0.0-alpha.8 (2025-11-26)
+
+Full Changelog: [v2.0.0-alpha.7...v2.0.0-alpha.8](https://github.com/togethercomputer/together-py/compare/v2.0.0-alpha.7...v2.0.0-alpha.8)
+
+### Features
+
+* **api:** api update ([49bb5d4](https://github.com/togethercomputer/together-py/commit/49bb5d4ba69ca118ecc34be2d69c4253665e2e81))
+* **api:** Fix internal references for VideoJob spec ([fb5e7bb](https://github.com/togethercomputer/together-py/commit/fb5e7bb3dbaa9427d291de7440c201529b6cf528))
+
+
+### Bug Fixes
+
+* Address incorrect logic for `endpoint [command] --wait false` logic ([31236a9](https://github.com/togethercomputer/together-py/commit/31236a9df29c22fe7444c2dbb0d4bfc518bc79aa))
+
+
+### Chores
+
+* Remove incorrect file upload docs ([5bb847e](https://github.com/togethercomputer/together-py/commit/5bb847e33b55e5d0978c742e86cf931a2c08f919))
+* Remove incorrect file upload docs ([bb97093](https://github.com/togethercomputer/together-py/commit/bb970938650b6f9580538528979221d142f74b6a))
+
+## 2.0.0-alpha.7 (2025-11-26)
+
+Full Changelog: [v2.0.0-alpha.6...v2.0.0-alpha.7](https://github.com/togethercomputer/together-py/compare/v2.0.0-alpha.6...v2.0.0-alpha.7)
+
+### Bug Fixes
+
+* include rich in package dependencies ([9c9c5fc](https://github.com/togethercomputer/together-py/commit/9c9c5fcc29183e1598418684391b480d4052c9b9))
+
 ## 2.0.0-alpha.6 (2025-11-25)
 
 Full Changelog: [v2.0.0-alpha.5...v2.0.0-alpha.6](https://github.com/togethercomputer/together-py/compare/v2.0.0-alpha.5...v2.0.0-alpha.6)

{together-2.0.0a6 → together-2.0.0a8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: together
-Version: 2.0.0a6
+Version: 2.0.0a8
 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
@@ -29,6 +29,7 @@ Requires-Dist: filelock>=3.13.1
 Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pillow>=10.4.0
 Requires-Dist: pydantic<3,>=1.9.0
+Requires-Dist: rich>=13.7.1
 Requires-Dist: sniffio
 Requires-Dist: tabulate>=0.9.0
 Requires-Dist: tqdm>=4.67.1
@@ -243,22 +244,6 @@ chat_completion = client.chat.completions.create(
 print(chat_completion.response_format)
 ```
 
-## File uploads
-
-Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
-
-```python
-from pathlib import Path
-from together import Together
-
-client = Together()
-
-client.files.upload(
-    file=Path("/path/to/file"),
-    purpose="fine-tune",
-)
-```
-
 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.
 
 ## Handling errors
@@ -527,40 +512,6 @@ with Together() as client:
 
 ## Usage – CLI
 
-### Chat Completions
-
-```bash
-together chat.completions \
-  --message "system" "You are a helpful assistant named Together" \
-  --message "user" "What is your name?" \
-  --model mistralai/Mixtral-8x7B-Instruct-v0.1
-```
-
-The Chat Completions CLI enables streaming tokens to stdout by default. To disable streaming, use `--no-stream`.
-
-### Completions
-
-```bash
-together completions \
-  "Large language models are " \
-  --model mistralai/Mixtral-8x7B-v0.1 \
-  --max-tokens 512 \
-  --stop "."
-```
-
-The Completions CLI enables streaming tokens to stdout by default. To disable streaming, use `--no-stream`.
-
-### Image Generations
-
-```bash
-together images generate \
-  "space robots" \
-  --model stabilityai/stable-diffusion-xl-base-1.0 \
-  --n 4
-```
-
-The image is opened in the default image viewer by default. To disable this, use `--no-show`.
-
 ### Files
 
 ```bash

{together-2.0.0a6 → together-2.0.0a8}/README.md

@@ -198,22 +198,6 @@ chat_completion = client.chat.completions.create(
 print(chat_completion.response_format)
 ```
 
-## File uploads
-
-Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
-
-```python
-from pathlib import Path
-from together import Together
-
-client = Together()
-
-client.files.upload(
-    file=Path("/path/to/file"),
-    purpose="fine-tune",
-)
-```
-
 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.
 
 ## Handling errors
@@ -482,40 +466,6 @@ with Together() as client:
 
 ## Usage – CLI
 
-### Chat Completions
-
-```bash
-together chat.completions \
-  --message "system" "You are a helpful assistant named Together" \
-  --message "user" "What is your name?" \
-  --model mistralai/Mixtral-8x7B-Instruct-v0.1
-```
-
-The Chat Completions CLI enables streaming tokens to stdout by default. To disable streaming, use `--no-stream`.
-
-### Completions
-
-```bash
-together completions \
-  "Large language models are " \
-  --model mistralai/Mixtral-8x7B-v0.1 \
-  --max-tokens 512 \
-  --stop "."
-```
-
-The Completions CLI enables streaming tokens to stdout by default. To disable streaming, use `--no-stream`.
-
-### Image Generations
-
-```bash
-together images generate \
-  "space robots" \
-  --model stabilityai/stable-diffusion-xl-base-1.0 \
-  --n 4
-```
-
-The image is opened in the default image viewer by default. To disable this, use `--no-show`.
-
 ### Files
 
 ```bash

{together-2.0.0a6 → together-2.0.0a8}/api.md

@@ -134,12 +134,12 @@ Methods:
 Types:
 
 ```python
-from together.types import VideoJob, VideoCreateResponse
+from together.types import VideoJob
 ```
 
 Methods:
 
-- <code title="post /videos">client.videos.<a href="./src/together/resources/videos.py">create</a>(\*\*<a href="src/together/types/video_create_params.py">params</a>) -> <a href="./src/together/types/video_create_response.py">VideoCreateResponse</a></code>
+- <code title="post /videos">client.videos.<a href="./src/together/resources/videos.py">create</a>(\*\*<a href="src/together/types/video_create_params.py">params</a>) -> <a href="./src/together/types/video_job.py">VideoJob</a></code>
 - <code title="get /videos/{id}">client.videos.<a href="./src/together/resources/videos.py">retrieve</a>(id) -> <a href="./src/together/types/video_job.py">VideoJob</a></code>
 
 # Audio

{together-2.0.0a6 → together-2.0.0a8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "together"
-version = "2.0.0-alpha.6"
+version = "2.0.0-alpha.8"
 description = "The official Python library for the together API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -15,6 +15,7 @@ dependencies = [
     "distro>=1.7.0, <2",
     "sniffio",
     "click>=8.1.7",
+    "rich>=13.7.1",
     "tabulate>=0.9.0",
     "pillow>=10.4.0",
     "types-tabulate>=0.9.0.20240106",

{together-2.0.0a6 → together-2.0.0a8}/requirements-dev.lock

@@ -122,6 +122,7 @@ python-dateutil==2.9.0.post0 ; python_full_version < '3.10'
     # via time-machine
 respx==0.22.0
 rich==14.2.0
+    # via together
 ruff==0.14.6
 six==1.17.0 ; python_full_version < '3.10'
     # via python-dateutil

{together-2.0.0a6 → together-2.0.0a8}/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.6"  # x-release-please-version
+__version__ = "2.0.0-alpha.8"  # x-release-please-version

{together-2.0.0a6 → together-2.0.0a8}/src/together/lib/cli/api/endpoints.py

@@ -128,8 +128,7 @@ def endpoints(ctx: click.Context) -> None:
     help="Start endpoint in specified availability zone (e.g., us-central-4b)",
 )
 @click.option(
-    "--wait",
-    is_flag=True,
+    "--wait/--no-wait",
     default=True,
     help="Wait for the endpoint to be ready after creation",
 )
@@ -272,7 +271,7 @@ def fetch_and_print_hardware_options(client: Together, model: str | None, print_
 
 @endpoints.command()
 @click.argument("endpoint-id", required=True)
-@click.option("--wait", is_flag=True, default=True, help="Wait for the endpoint to stop")
+@click.option("--wait/--no-wait", default=True, help="Wait for the endpoint to stop")
 @click.pass_obj
 @handle_api_errors
 def stop(client: Together, endpoint_id: str, wait: bool) -> None:
@@ -293,7 +292,7 @@ def stop(client: Together, endpoint_id: str, wait: bool) -> None:
 
 @endpoints.command()
 @click.argument("endpoint-id", required=True)
-@click.option("--wait", is_flag=True, default=True, help="Wait for the endpoint to start")
+@click.option("--wait/--no-wait", default=True, help="Wait for the endpoint to start")
 @click.pass_obj
 @handle_api_errors
 def start(client: Together, endpoint_id: str, wait: bool) -> None:

{together-2.0.0a6 → together-2.0.0a8}/src/together/lib/types/fine_tuning.py

@@ -70,9 +70,6 @@ class FinetuneEventLevels(str, Enum):
     INFO = "Info"
     WARNING = "Warning"
     ERROR = "Error"
-    LEGACY_INFO = "info"
-    LEGACY_IWARNING = "warning"
-    LEGACY_IERROR = "error"
 
 
 class FinetuneEvent(BaseModel):
@@ -85,7 +82,7 @@ class FinetuneEvent(BaseModel):
     # created at datetime stamp
     created_at: Union[str, None] = None
     # event log level
-    level: Union[FinetuneEventLevels, None] = None
+    level: Union[FinetuneEventLevels, str, None] = None
     # event message string
     message: Union[str, None] = None
     # event type
@@ -120,7 +117,20 @@ class LoRATrainingType(BaseModel):
     type: Literal["Lora"] = "Lora"
 
 
-TrainingType: TypeAlias = Union[FullTrainingType, LoRATrainingType]
+class UnknownTrainingType(BaseModel):
+    """
+    Catch-all for unknown training types (forward compatibility).
+    Accepts any training type not explicitly defined.
+    """
+
+    type: str
+
+
+TrainingType: TypeAlias = Union[
+    FullTrainingType,
+    LoRATrainingType,
+    UnknownTrainingType,
+]
 
 
 class FinetuneFullTrainingLimits(BaseModel):
@@ -163,7 +173,19 @@ class TrainingMethodDPO(BaseModel):
     simpo_gamma: Union[float, None] = None
 
 
-TrainingMethod: TypeAlias = Union[TrainingMethodSFT, TrainingMethodDPO]
+class TrainingMethodUnknown(BaseModel):
+    """
+    Catch-all for unknown training methods (forward compatibility).
+    Accepts any training method not explicitly defined.
+    """
+
+    method: str
+
+TrainingMethod: TypeAlias = Union[
+    TrainingMethodSFT,
+    TrainingMethodDPO,
+    TrainingMethodUnknown,
+]
 
 
 class FinetuneTrainingLimits(BaseModel):
@@ -175,31 +197,67 @@ class FinetuneTrainingLimits(BaseModel):
 
 
 class LinearLRSchedulerArgs(BaseModel):
+    """
+    Linear learning rate scheduler arguments
+    """
+
     min_lr_ratio: Union[float, None] = 0.0
 
 
 class CosineLRSchedulerArgs(BaseModel):
+    """
+    Cosine learning rate scheduler arguments
+    """
+
     min_lr_ratio: Union[float, None] = 0.0
     num_cycles: Union[float, None] = 0.5
 
 
 class LinearLRScheduler(BaseModel):
+    """
+    Linear learning rate scheduler
+    """
+
     lr_scheduler_type: Literal["linear"] = "linear"
     lr_scheduler_args: Union[LinearLRSchedulerArgs, None] = None
 
 
 class CosineLRScheduler(BaseModel):
+    """
+    Cosine learning rate scheduler
+    """
+
     lr_scheduler_type: Literal["cosine"] = "cosine"
     lr_scheduler_args: Union[CosineLRSchedulerArgs, None] = None
 
 
-# placeholder for old fine-tuning jobs with no lr_scheduler_type specified
 class EmptyLRScheduler(BaseModel):
+    """
+    Empty learning rate scheduler
+
+    Placeholder for old fine-tuning jobs with no lr_scheduler_type specified
+    """
+
     lr_scheduler_type: Literal[""]
     lr_scheduler_args: None = None
 
+class UnknownLRScheduler(BaseModel):
+    """
+    Unknown learning rate scheduler
+
+    Catch-all for unknown LR scheduler types (forward compatibility)
+    """
+
+    lr_scheduler_type: str
+    lr_scheduler_args: Optional[Any] = None
+
 
-FinetuneLRScheduler: TypeAlias = Union[LinearLRScheduler, CosineLRScheduler, EmptyLRScheduler]
+FinetuneLRScheduler: TypeAlias = Union[
+    LinearLRScheduler,
+    CosineLRScheduler,
+    EmptyLRScheduler,
+    UnknownLRScheduler,
+]
 
 
 class FinetuneResponse(BaseModel):
@@ -213,8 +271,8 @@ class FinetuneResponse(BaseModel):
     created_at: datetime
     """Creation timestamp of the fine-tune job"""
 
-    status: Optional[FinetuneJobStatus] = None
-    """Status of the fine-tune job"""
+    status: Optional[Union[FinetuneJobStatus, str]] = None
+    """Status of the fine-tune job (accepts known enum values or string for forward compatibility)"""
 
     updated_at: datetime
     """Last update timestamp of the fine-tune job"""
@@ -222,8 +280,8 @@ class FinetuneResponse(BaseModel):
     batch_size: Optional[int] = None
     """Batch size used for training"""
 
-    events: Optional[List[FinetuneEvent]] = None
-    """Events related to this fine-tune job"""
+    events: Optional[List[Union[FinetuneEvent, str]]] = None
+    """Events related to this fine-tune job (accepts known enum values or string for forward compatibility)"""
 
     from_checkpoint: Optional[str] = None
     """Checkpoint used to continue training"""
@@ -361,7 +419,7 @@ class FinetuneRequest(BaseModel):
     # training learning rate
     learning_rate: float
     # learning rate scheduler type and args
-    lr_scheduler: Union[LinearLRScheduler, CosineLRScheduler, None] = None
+    lr_scheduler: Union[FinetuneLRScheduler, None] = None
     # learning rate warmup ratio
     warmup_ratio: float
     # max gradient norm
@@ -387,7 +445,7 @@ class FinetuneRequest(BaseModel):
     # training type
     training_type: Union[TrainingType, None] = None
     # training method
-    training_method: Union[TrainingMethodSFT, TrainingMethodDPO] = Field(default_factory=TrainingMethodSFT)
+    training_method: TrainingMethod = Field(default_factory=TrainingMethodSFT)
     # from step
     from_checkpoint: Union[str, None] = None
     from_hf_model: Union[str, None] = None

{together-2.0.0a6 → together-2.0.0a8}/src/together/resources/fine_tuning.py

@@ -291,7 +291,7 @@ class FineTuningResource(SyncAPIResource):
         self,
         id: str,
         *,
-        force: bool,
+        force: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -374,7 +374,7 @@ class FineTuningResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BinaryAPIResponse:
         """
-        Download a compressed fine-tuned model or checkpoint.
+        Receive a compressed fine-tuned model or checkpoint.
 
         Args:
           ft_id: Fine-tune ID to download. A string that starts with `ft-`.
@@ -732,7 +732,7 @@ class AsyncFineTuningResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        force: bool,
+        force: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -815,7 +815,7 @@ class AsyncFineTuningResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncBinaryAPIResponse:
         """
-        Download a compressed fine-tuned model or checkpoint.
+        Receive a compressed fine-tuned model or checkpoint.
 
         Args:
           ft_id: Fine-tune ID to download. A string that starts with `ft-`.

{together-2.0.0a6 → together-2.0.0a8}/src/together/resources/videos.py

@@ -20,7 +20,6 @@ from .._response import (
 )
 from .._base_client import make_request_options
 from ..types.video_job import VideoJob
-from ..types.video_create_response import VideoCreateResponse
 
 __all__ = ["VideosResource", "AsyncVideosResource"]
 
@@ -68,7 +67,7 @@ class VideosResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VideoCreateResponse:
+    ) -> VideoJob:
         """
         Create a video
 
@@ -139,7 +138,7 @@ class VideosResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VideoCreateResponse,
+            cast_to=VideoJob,
         )
 
     def retrieve(
@@ -219,7 +218,7 @@ class AsyncVideosResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VideoCreateResponse:
+    ) -> VideoJob:
         """
         Create a video
 
@@ -290,7 +289,7 @@ class AsyncVideosResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VideoCreateResponse,
+            cast_to=VideoJob,
         )
 
     async def retrieve(

{together-2.0.0a6 → together-2.0.0a8}/src/together/types/__init__.py

@@ -46,7 +46,6 @@ from .batch_create_response import BatchCreateResponse as BatchCreateResponse
 from .image_generate_params import ImageGenerateParams as ImageGenerateParams
 from .job_retrieve_response import JobRetrieveResponse as JobRetrieveResponse
 from .model_upload_response import ModelUploadResponse as ModelUploadResponse
-from .video_create_response import VideoCreateResponse as VideoCreateResponse
 from .endpoint_create_params import EndpointCreateParams as EndpointCreateParams
 from .endpoint_list_response import EndpointListResponse as EndpointListResponse
 from .endpoint_update_params import EndpointUpdateParams as EndpointUpdateParams

{together-2.0.0a6 → together-2.0.0a8}/src/together/types/fine_tuning_delete_params.py

@@ -2,10 +2,10 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import TypedDict
 
 __all__ = ["FineTuningDeleteParams"]
 
 
 class FineTuningDeleteParams(TypedDict, total=False):
-    force: Required[bool]
+    force: bool

{together-2.0.0a6 → together-2.0.0a8}/tests/api_resources/test_fine_tuning.py

@@ -97,6 +97,13 @@ class TestFineTuning:
 
     @parametrize
     def test_method_delete(self, client: Together) -> None:
+        fine_tuning = client.fine_tuning.delete(
+            id="id",
+        )
+        assert_matches_type(FineTuningDeleteResponse, fine_tuning, path=["response"])
+
+    @parametrize
+    def test_method_delete_with_all_params(self, client: Together) -> None:
         fine_tuning = client.fine_tuning.delete(
             id="id",
             force=True,
@@ -107,7 +114,6 @@ class TestFineTuning:
     def test_raw_response_delete(self, client: Together) -> None:
         response = client.fine_tuning.with_raw_response.delete(
             id="id",
-            force=True,
         )
 
         assert response.is_closed is True
@@ -119,7 +125,6 @@ class TestFineTuning:
     def test_streaming_response_delete(self, client: Together) -> None:
         with client.fine_tuning.with_streaming_response.delete(
             id="id",
-            force=True,
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -134,7 +139,6 @@ class TestFineTuning:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
             client.fine_tuning.with_raw_response.delete(
                 id="",
-                force=True,
             )
 
     @parametrize
@@ -378,6 +382,13 @@ class TestAsyncFineTuning:
 
     @parametrize
     async def test_method_delete(self, async_client: AsyncTogether) -> None:
+        fine_tuning = await async_client.fine_tuning.delete(
+            id="id",
+        )
+        assert_matches_type(FineTuningDeleteResponse, fine_tuning, path=["response"])
+
+    @parametrize
+    async def test_method_delete_with_all_params(self, async_client: AsyncTogether) -> None:
         fine_tuning = await async_client.fine_tuning.delete(
             id="id",
             force=True,
@@ -388,7 +399,6 @@ class TestAsyncFineTuning:
     async def test_raw_response_delete(self, async_client: AsyncTogether) -> None:
         response = await async_client.fine_tuning.with_raw_response.delete(
             id="id",
-            force=True,
         )
 
         assert response.is_closed is True
@@ -400,7 +410,6 @@ class TestAsyncFineTuning:
     async def test_streaming_response_delete(self, async_client: AsyncTogether) -> None:
         async with async_client.fine_tuning.with_streaming_response.delete(
             id="id",
-            force=True,
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -415,7 +424,6 @@ class TestAsyncFineTuning:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
             await async_client.fine_tuning.with_raw_response.delete(
                 id="",
-                force=True,
             )
 
     @parametrize