Together Sandbox

Tools for working with Together AI sandboxes: a CLI, a TypeScript SDK, and a Python SDK.

Quick Start

All three components can be installed directly from GitHub without npm or PyPI publication:

# CLI
curl -fsSL https://raw.githubusercontent.com/togethercomputer/together-sandbox/main/install.sh | bash

# TypeScript SDK
npm install together-sandbox

# Python SDK
pip install together-sandbox

Docs

• Sandboxes and Snapshots
• Harbor Integration Guide
• CLI
• TypeScript SDK
• Python SDK

Development

Regenerating clients

If the OpenAPI specs change, regenerate all clients from the repo root:

bash generate.sh

Release Process

Releases are fully automated via release-please — no manual tagging or version bumping required.

How it works

1. Merge PRs to main using Conventional Commits — the commit type determines what kind of release is created:

   • feat: → minor version bump
   • fix: → patch version bump
   • feat!: / BREAKING CHANGE: → major version bump
   • chore:, docs:, etc. → no release

2. release-please opens a "Release PR" automatically, accumulating changes and updating CHANGELOG.md plus all three version files in sync:

   • together-sandbox-typescript/package.json
   • together-sandbox-cli/package.json
   • together-sandbox-python/pyproject.toml

3. Merge the Release PR → release-please creates the GitHub Release and tag automatically.

4. Three publish jobs fan out in parallel, all gated on the release-please tag:

   • build-and-upload — compiles CLI binaries for all 5 platforms (darwin arm64/x64, linux x64/arm64, windows x64) and attaches them to the GitHub Release.
   • publish-npm — regenerates SDK clients, builds the TypeScript SDK, and runs npm publish to publish together-sandbox to npm using OIDC trusted publishing (no token).
   • publish-pypi — regenerates SDK clients, runs python -m build, and publishes together-sandbox to PyPI using OIDC trusted publishing (no token).

   Both publish jobs run inside protected GitHub Environments (npm and pypi) so deploys are restricted to main.

The only human action required is keeping commits conventional and merging the Release PR when ready to ship.