Skip to main content

​
Job Commands

Manage your ML training jobs with the tp job command group.

​
tp job init

Create a new job configuration file. 
tp job init
Behavior:
  • Creates a tp.config.toml file in the current directory
  • If the file exists, creates tp.config1.toml, tp.config2.toml, etc.
  • Prompts for a custom name (e.g., entering “baseline” creates tp.baseline.toml)
  • Use --no-input to skip prompts and use default names
Example: 
$ tp job init
Enter a name for the tp config, or press ENTER to use tp.config.toml
> experiment1
tp.experiment1.toml created
Configure it to do `tp job push tp.experiment1.toml`

​
tp job push

Submit a job to run on TensorPool. 
tp job push <tp_config_path>
Arguments:
  • tp_config_path - Path to your tp.[config].toml configuration file
Requirements:
  • Valid TOML configuration file with commands, instance_type, outputs, and ignore fields
  • SSH key pair at ~/.ssh/id_ed25519 and ~/.ssh/id_ed25519.pub
Example: 
tp job push tp.config.toml

​
tp job list

List all your jobs. 
tp job list [--org]
Aliases: tp job ls Options:
  • --org, --organization - List all jobs in your organization (not just yours)
Example: 
tp job list
tp job list --org

​
tp job info

Get detailed information about a specific job. 
tp job info <job_id>
Arguments:
  • job_id - The ID of the job to inspect
Example: 
tp job info job_abc123

​
tp job listen

Stream real-time logs from a running job. 
tp job listen <job_id>
Arguments:
  • job_id - The ID of the job to monitor
Behavior:
  • Continuously streams stdout/stderr from the job
  • Updates in real-time as the job runs
  • Press Ctrl+C to stop listening (job continues running)
Example: 
tp job listen job_abc123

​
tp job pull

Download output files from a completed job. 
tp job pull <job_id> [--force]
Arguments:
  • job_id - The ID of the job to pull outputs from
Options:
  • --force - Overwrite existing local files without prompting
Behavior:
  • Downloads files specified in the outputs configuration
  • By default, skips files that already exist locally
  • Requires SSH keys (~/.ssh/id_ed25519 and ~/.ssh/id_ed25519.pub)
Example: 
# Download outputs (skip existing files)
tp job pull job_abc123

# Force overwrite existing files
tp job pull job_abc123 --force

​
tp job cancel

Cancel a running or queued job. 
tp job cancel <job_id> [--no-input]
Arguments:
  • job_id - The ID of the job to cancel
Options:
  • --no-input - Skip confirmation prompt
Behavior:
  • Prompts for confirmation before canceling (unless --no-input is used)
  • Terminates running jobs immediately
  • Removes queued jobs from the queue
Example: 
# Cancel with confirmation
tp job cancel job_abc123

# Cancel without confirmation
tp job cancel job_abc123 --no-input
Jobs require SSH authentication. Manage your SSH keys with:

​
Next Steps