Skip to main content
Jobs allow you to run many AI tasks in parallel using batch processing. Read the introduction for a lexicon on jobs, tasks, and executions.

​
Quickstart

It is required to have npm (TypeScript) or uv (Python) installed to use the following command.
You can quickly initialize a new job from scratch by using the CLI command bl new job. 
bl new job
This will create a pre-scaffolded local directory where your entire code can be added. In the generated folder, you’ll find a boilerplate job with multiple steps in the entrypoint file src/index.ts / src/main.py. You can update this boilerplate job to your specific requirements, and manage and control job execution using the Blaxel TypeScript or Python SDKs. The template used to generate the boilerplate job is available in Blaxel’s public GitHub repository (TypeScript / Python). Start the job locally: 
# Run the job with a sample batch file
bl run job <<JOB-NAME>> --local --file batches/sample-batch.json

# Or directly with --data argument
bl run job <<JOB-NAME>> --local --data '{"tasks": [{"name": "John"}]}'

# Or without blaxel CLI
pnpm start --name John

TypeScript

Manage batch job execution using the Blaxel TypeScript SDK.

Python

Manage batch job execution using the Blaxel Python SDK.

Deploy a job

Learn how to deploy your AI batch jobs on Blaxel as a serverless auto-scalable endpoint.