osmosis quickstart once before following the Multiply Quickstart or building a custom rollout. The wizard signs you in, resolves your workspace, and clones its GitHub workspace repository into a local workspace directory. You only need the Platform to create or join a workspace, plus a workspace owner or admin to connect GitHub the first time.
Quickstart Wizard
osmosis quickstart is the shortest path through setup. It checks each requirement, fixes what it can, and ends by pointing you at your next step. For most goals, that next step is a prompt you paste into your AI coding agent.
Install the CLI:
1
Authenticate the CLI
The wizard opens the browser login flow when you have no valid credentials, and skips this step when you do.
2
Resolve the workspace
Run from inside a workspace directory and the CLI infers the workspace from GitHub
origin. Anywhere else, it lists your workspaces and asks which one to use; if you belong to a single workspace, it selects that one.3
Connect and clone the workspace repository
If no repository is connected yet, the wizard prints the Git Integration URL and waits while a workspace owner or admin connects GitHub and creates the repository.Once the repository is connected, the wizard asks where to clone it over HTTPS or SSH, defaulting to
./<repo-name>, and continues from that directory. Point the prompt at an existing clone of the same repository to continue from it instead of cloning again.4
Check billing
When the workspace has no payment method on file, the wizard prints the billing URL and continues. Paid features — training runs, evaluation runs, benchmarks, and deployments — need billing set up, but setup itself is never blocked.
5
Choose what you want to do
The wizard asks whether you want to train a model for a task, run an evaluation on a dataset, run a benchmark, or just explore for now. The training and evaluation options also ask you to describe your task.
6
Paste the prompt into your AI agent
For the training, evaluation, and benchmark goals, the wizard prints an agent prompt matching your answers and copies it to your clipboard when one is available. Open your AI coding agent in the cloned workspace directory and paste the prompt to start. Choosing Just exploring for now prints documentation links instead of a prompt.
osmosis quickstart is safe to re-run. It checks the current state of your workspace instead of saved progress, so Ctrl+C is safe at any point, and an already-configured workspace gets an all-clear report and goes straight to asking what you want to do next.Choose Your First Workflow
Multiply Quickstart
Run the included
multiply-local-openai example end to end with copy-paste commands.Custom Rollout Guide
Use the workspace’s project-local Agent Skills to plan training, create a rollout, and validate it with an evaluation run.
Manual Setup
These are the steps the wizard automates. Follow them directly for reference, or in non-interactive environments —osmosis quickstart needs an interactive terminal.
1
Create or join a platform workspace
If you are creating a new workspace, sign in to the platform and create it there. If you were invited, accept the invitation and open the existing workspace.
2
Set up the workspace repository
Workspace owners or admins connect a GitHub account or organization, install the Osmosis GitHub App, and create the workspace repository from the platform.Repositories created from the platform include the starter examples
multiply-local-strands, multiply-local-openai, and multiply-harbor-strands.Invited workspace members use the workspace repository that already exists. Do not create a second repository for the same workspace.3
Clone the workspace repository
The platform shows clone commands once a repository is connected. Choose HTTPS, SSH, or GitHub CLI:
4
Install and authenticate the CLI
Install the Osmosis CLI and connect it to your account:Run platform commands from inside the workspace directory. The CLI reads GitHub
origin to identify the platform workspace connected to this repository.5
Verify local workspace context
From the cloned workspace directory, confirm the CLI can resolve your workspace:
Workspace Repository vs Directory
If Setup Is Blocked
The platform may show a GitHub banner when the workspace is missing required repository setup.For details on how Git Sync controls the code version used for training, see Git Sync.
Next Steps
Multiply Quickstart
Copy and paste the shortest path from cloned repository to training run.
Custom Rollout Guide
Build a task-specific rollout with project-local Agent Skills and evaluation run gates.
Workspace Repository
Understand how the CLI maps your Git clone to a platform workspace.