release: 2.1.0 (#246)

* Update README.md (#245)

* Add from_checkpoint parameter to price estimation for FT Job creation (#247)

* codegen metadata

* codegen metadata

* codegen metadata

* jig papercuts (#238)

* feat(jig): show a unique name tip when deployment create fails

* feat(jig): factor out config_path option and add short flag

* feat: jig support for multi deployment

* codegen metadata

* chore: Update descriptions for jig queue methods and properties

* chore(internal): bump dependencies

* Allow tool calls through together-py and remove alternating roles check (#244)

* Update README.md (#245)

* Add from_checkpoint parameter to price estimation for FT Job creation (#247)

* codegen metadata

* codegen metadata

* codegen metadata

* Allow tool calls through together-py and remove outdated checks

* Remove outdated tests

* lint

* Enforce that either content or tool calls exists

* Skip for empty content

* Condition field checks on role

---------

Co-authored-by: Blaine Kasten <blainekasten@gmail.com>
Co-authored-by: Artem Chumachenko <artek.chumak@gmail.com>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

* make submit --watch signal status through exit code

* fix(cli): fine-tuning retrieve now renders data instead of schema (#250)

* fix(jig): lint errors

* fix(jig): migrate old state files properly and be even more defensive about parsing deploy errors

* fix(jig): pyright does not handle isinstance type narrowing in ternary expressions. also fix migration logic

* format code

* release: 2.1.0

---------

Co-authored-by: Blaine Kasten <blainekasten@gmail.com>
Co-authored-by: Artem Chumachenko <artek.chumak@gmail.com>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: technillogue <technillogue@gmail.com>
Co-authored-by: Mohamad Rostami <mbrostami@proton.me>
Co-authored-by: Conner Manuel <57027354+connermanuel@users.noreply.github.com>

Author: 6 people

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.0.0"
+  ".": "2.1.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 74
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-dc45695614158674dec4da8ae843a7564905f24d2ce577e8e6e5246b4a7b0f61.yml
-openapi_spec_hash: 46a91a84c8c270792676ee863b33ab99
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-d0664effad76cfb3a97290815ced94d0766121ee8f0ac137ecc18bd8b5f9c7e8.yml
+openapi_spec_hash: b56c7850a7a3d3827ab65c6f0aebe394
 config_hash: 67b76d1064bef2e591cadf50de08ad19

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 2.1.0 (2026-02-10)
+
+Full Changelog: [v2.0.0...v2.1.0](https://github.com/togethercomputer/together-py/compare/v2.0.0...v2.1.0)
+
+### Features
+
+* **cli:** improve error messages for endpoint creation failures ([#230](https://github.com/togethercomputer/together-py/issues/230)) ([0285a69](https://github.com/togethercomputer/together-py/commit/0285a69893688938068d235aa109a5d7678cb713))
+* jig support for multi deployment ([d1165fd](https://github.com/togethercomputer/together-py/commit/d1165fd786533e37ed401f4bb60601b39473a5d8))
+
+
+### Bug Fixes
+
+* **cli:** fine-tuning retrieve now renders data instead of schema ([#250](https://github.com/togethercomputer/together-py/issues/250)) ([52cde25](https://github.com/togethercomputer/together-py/commit/52cde258d39644a5a9706fc8f491c951115aa16d))
+* **jig:** lint errors ([07f4d34](https://github.com/togethercomputer/together-py/commit/07f4d340ebd24247d0d280ce53cac768f76e03b8))
+* **jig:** migrate old state files properly and be even more defensive about parsing deploy errors ([92ef79b](https://github.com/togethercomputer/together-py/commit/92ef79b4229953d8e463bebe8027420c8e8decfe))
+* **jig:** pyright does not handle isinstance type narrowing in ternary expressions. also fix migration logic ([bf5267f](https://github.com/togethercomputer/together-py/commit/bf5267ff65fa409c21d3ac92e794dfd83f70c300))
+* remove hardcoded API key from image example ([#254](https://github.com/togethercomputer/together-py/issues/254)) ([8f2c60c](https://github.com/togethercomputer/together-py/commit/8f2c60c8fa4c2352e5768aa47876dd51b379df6b))
+
+
+### Chores
+
+* **internal:** bump dependencies ([c9678ff](https://github.com/togethercomputer/together-py/commit/c9678ff922fa549261c5db2af5be60f719e6a1cf))
+* Update descriptions for jig queue methods and properties ([23be158](https://github.com/togethercomputer/together-py/commit/23be1581cf1986bf4e9474e70f6e1029bc082ec4))
+
 ## 2.0.0 (2026-02-04)
 
 Full Changelog: [v2.0.0-alpha.20...v2.0.0](https://github.com/togethercomputer/together-py/compare/v2.0.0-alpha.20...v2.0.0)

README.md

@@ -16,8 +16,11 @@ The REST API documentation can be found on [docs.together.ai](https://docs.toget
 ## Installation
 
 ```sh
-# install from PyPI
-pip install '--pre together'
+pip install together
+```
+
+```sh
+uv add together
 ```
 
 ## Usage

pyproject.toml

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

requirements-dev.lock

@@ -3,12 +3,12 @@
 -e .
 aiohappyeyeballs==2.6.1
     # via aiohttp
-aiohttp==3.13.2
+aiohttp==3.13.3
 aiosignal==1.4.0
     # via aiohttp
 annotated-types==0.7.0
     # via pydantic
-anyio==4.12.0
+anyio==4.12.1
     # via
     #   httpx
     #   together
@@ -18,7 +18,7 @@ attrs==25.4.0
     # via aiohttp
 backports-asyncio-runner==1.2.0 ; python_full_version < '3.11'
     # via pytest-asyncio
-certifi==2025.11.12
+certifi==2026.1.4
     # via
     #   httpcore
     #   httpx
@@ -42,7 +42,7 @@ execnet==2.1.2
     # via pytest-xdist
 filelock==3.19.1 ; python_full_version < '3.10'
     # via together
-filelock==3.20.0 ; python_full_version >= '3.10'
+filelock==3.20.3 ; python_full_version >= '3.10'
     # via together
 frozenlist==1.8.0
     # via
@@ -61,7 +61,7 @@ idna==3.11
     #   anyio
     #   httpx
     #   yarl
-importlib-metadata==8.7.0
+importlib-metadata==8.7.1
 iniconfig==2.1.0 ; python_full_version < '3.10'
     # via pytest
 iniconfig==2.3.0 ; python_full_version >= '3.10'
@@ -79,15 +79,15 @@ multidict==6.7.0
 mypy==1.17.0
 mypy-extensions==1.1.0
     # via mypy
-nodeenv==1.9.1
+nodeenv==1.10.0
     # via pyright
 packaging==25.0
     # via pytest
-pathspec==0.12.1
+pathspec==1.0.3
     # via mypy
 pillow==11.3.0 ; python_full_version < '3.10'
     # via together
-pillow==12.0.0 ; python_full_version >= '3.10'
+pillow==12.1.0 ; python_full_version >= '3.10'
     # via together
 pluggy==1.6.0
     # via pytest
@@ -109,7 +109,7 @@ pytest==8.4.2 ; python_full_version < '3.10'
     #   pytest-asyncio
     #   pytest-mock
     #   pytest-xdist
-pytest==9.0.1 ; python_full_version >= '3.10'
+pytest==9.0.2 ; python_full_version >= '3.10'
     # via
     #   pytest-asyncio
     #   pytest-mock
@@ -123,26 +123,29 @@ python-dateutil==2.9.0.post0 ; python_full_version < '3.10'
 respx==0.22.0
 rich==14.2.0
     # via together
-ruff==0.14.7
+ruff==0.14.13
 six==1.17.0 ; python_full_version < '3.10'
     # via python-dateutil
 sniffio==1.3.1
     # via together
 tabulate==0.9.0
     # via together
 time-machine==2.19.0 ; python_full_version < '3.10'
-time-machine==3.1.0 ; python_full_version >= '3.10'
-tomli==2.3.0 ; python_full_version < '3.11'
+time-machine==3.2.0 ; python_full_version >= '3.10'
+tomli==2.4.0 ; python_full_version < '3.11'
     # via
     #   mypy
     #   pytest
-tqdm==4.67.1
+    #   together
+tqdm==4.67.3
+    # via together
+types-pyyaml==6.0.12.20250915
     # via together
-types-requests==2.32.4.20250913
+types-requests==2.32.4.20260107
     # via types-tqdm
 types-tabulate==0.9.0.20241207
     # via together
-types-tqdm==4.67.0.20250809
+types-tqdm==4.67.3.20260205
     # via together
 typing-extensions==4.15.0
     # via
@@ -159,7 +162,7 @@ typing-extensions==4.15.0
     #   typing-inspection
 typing-inspection==0.4.2
     # via pydantic
-urllib3==2.5.0
+urllib3==2.6.3
     # via types-requests
 yarl==1.22.0
     # via aiohttp

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"  # x-release-please-version
+__version__ = "2.1.0"  # x-release-please-version

src/together/lib/cli/api/beta/jig/_config.py

@@ -102,6 +102,7 @@ class Config:
     image: ImageConfig = field(default_factory=ImageConfig)
     deploy: DeployConfig = field(default_factory=DeployConfig)
     _path: Path = field(default_factory=lambda: Path("pyproject.toml"))
+    _unique_name_tip: str = "Update project.name in pyproject.toml"
 
     @classmethod
     def find(cls, config_path: Optional[str] = None, init: bool = False) -> Config:
@@ -132,17 +133,26 @@ def find(cls, config_path: Optional[str] = None, init: bool = False) -> Config:
     @classmethod
     def load(cls, data: dict[str, Any], path: Path) -> Config:
         """Load configuration from parsed TOML data"""
-        is_pyproject = path.name == "pyproject.toml"
-
-        jig_config = data.get("tool", {}).get("jig", {}) if is_pyproject else data
-
-        name = jig_config.get("name")
-        if name is None:
-            if is_pyproject:
-                name = data.get("project", {}).get("name", "")
+        # figure out config location and "Deployment name must be unique. Tip: update ..." message
+        is_pyproject = path.name.endswith("pyproject.toml")
+        if is_pyproject:
+            jig_config = data.get("tool", {}).get("jig", {})
+            if name := jig_config.get("name"):
+                tip = "update `name` in your pyproject.toml"
+            elif name := data.get("project", {}).get("name", ""):
+                tip = "update `project.name` in your pyproject.toml"
+            else:
+                name = path.resolve().parent.name
+                tip = "rename your folder or add `project.name` to your pyproject.toml"
+                click.echo(f"\N{PACKAGE} Name not set in {path} - defaulting to {name}")
+        else:
+            jig_config = data
+            if name := jig_config.get("name"):
+                tip = "update `name` in {path}"
             else:
                 name = path.resolve().parent.name
-                click.echo(f"\N{PACKAGE} Name not set in config file or pyproject.toml - defaulting to {name}")
+                tip = f"rename your folder or add `name` to {path}"
+                click.echo(f"\N{PACKAGE} Name not set in {path} - defaulting to {name}")
 
         if autoscaling := jig_config.get("autoscaling", {}):
             autoscaling["model"] = name
@@ -157,6 +167,7 @@ def load(cls, data: dict[str, Any], path: Path) -> Config:
             dockerfile=jig_config.get("dockerfile", "Dockerfile"),
             model_name=name,
             _path=path,
+            _unique_name_tip=tip,
         )
 
 
@@ -168,22 +179,67 @@ class State:
     """Persistent state stored in .jig.json"""
 
     _config_dir: Path
+    _project_name: str
     registry_base_path: str = ""
     secrets: dict[str, str] = field(default_factory=dict[str, str])
     volumes: dict[str, str] = field(default_factory=dict[str, str])
 
     @classmethod
-    def load(cls, config_dir: Path) -> State:
+    def from_dict(cls, config_dir: Path, project_name: str, **data: Any) -> State:
+        filtered = {k: v for k, v in data.items() if k in cls.__annotations__ and not k.startswith("_")}
+        return cls(_config_dir=config_dir, _project_name=project_name, **filtered)
+
+    @classmethod
+    def load(cls, config_dir: Path, project_name: str) -> State:
+        """Load state for a specific project from .jig.json.
+
+        The state file structure is:
+        {
+          "project-name-1": {
+            "registry_base_path": "...",
+            "secrets": {...},
+            "volumes": {...}
+          },
+          "project-name-2": {...}
+        }
+
+        """
         path = config_dir / ".jig.json"
         try:
             with open(path) as f:
-                data = {k: v for k, v in json.load(f).items() if k in cls.__annotations__ and not k.startswith("_")}
-                return cls(_config_dir=config_dir, **data)
+                all_data = json.load(f)
+
+                # Check if this is the new nested structure (project_name as key)
+                if project_name in all_data and isinstance(all_data[project_name], dict):
+                    # New structure: extract project-specific state
+                    project_data = all_data[project_name]
+                    return cls.from_dict(config_dir, project_name, **project_data)
+                # Secrets or volumes exist, but not yet migrated (don't care about registry base path)
+                if "secrets" in all_data or "volumes" in all_data:
+                    return cls.from_dict(config_dir, project_name, **all_data)
+                # File exists but this project isn't in it yet
+                return cls(_config_dir=config_dir, _project_name=project_name)
         except FileNotFoundError:
-            return cls(_config_dir=config_dir)
+            return cls(_config_dir=config_dir, _project_name=project_name)
 
     def save(self) -> None:
+        """Save state for this project to .jig.json.
+
+        Preserves other projects' state in the same file.
+        """
         path = self._config_dir / ".jig.json"
-        data = {k: v for k, v in asdict(self).items() if not k.startswith("_")}
+
+        # Load existing file to preserve other projects
+        try:
+            with open(path) as f:
+                all_data = json.load(f)
+        except FileNotFoundError:
+            all_data = {}
+
+        # Update this project's state
+        project_data = {k: v for k, v in asdict(self).items() if not k.startswith("_")}
+        all_data[self._project_name] = project_data
+
+        # Save back to file
         with open(path, "w") as f:
-            json.dump(data, f, indent=2)
+            json.dump(all_data, f, indent=2)