> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-cln-2792-remove-disable-bundling.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Workergroup Parameters

> Learn about the parameters that control which workers get recruited.

<script
  type="application/ld+json"
  dangerouslySetInnerHTML={{
__html: JSON.stringify({
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Configure Worker Recruitment (Workergroup Parameters)",
"description": "Learn about the Workergroup-only parameters that control which workers are recruited and how new workers are created.",
"step": [
  {
    "@type": "HowToStep",
    "name": "Understand Workergroup-only Parameters",
    "text": "These parameters apply to Workergroups only (not Endpoints). Vast pre-configured serverless templates typically set these values for you."
  },
  {
    "@type": "HowToStep",
    "name": "Set Hardware Requirements",
    "text": "Use gpu_ram and search_params to define minimum GPU memory and marketplace filtering criteria for the offers your Workergroup will consider."
  },
  {
    "@type": "HowToStep",
    "name": "Control Instance Creation Details",
    "text": "Use template_hash or template_id to select the template used to create instances. Use launch_args to add instance creation parameters beyond what’s provided by templates."
  }
]
})
}}
/>

The parameters below are specific to only Workergroups, not Endpoints. Pre-configured serverless templates from Vast will have these values already set.

## `gpu_ram`

The amount of GPU memory (VRAM) in gigabytes that your model or workload requires to run. This parameter is used by the serverless engine to estimate bandwidth requirements. The amount of GPU memory for recruited workers is specified as part of `search_params`.

If not specified during Workergroup creation, the default value is `24`.

## `launch_args`

A command-line style string containing additional parameters for instance creation that will be parsed and applied when the serverless engine creates new workers. This allows you to customize instance configuration beyond what’s specified in templates.

There is no default value for `launch_args`.

## `search_params`

A query string, list, or dictionary that specifies the hardware and performance criteria for filtering GPU offers in the vast.ai marketplace. It uses a simple query syntax to define requirements for the machines that your Workergroup will consider when searching for workers to create.

Example (Python):

```python icon="python" Python theme={null}
{"verified": {"eq": true}, "rentable": {"eq": true}, "rented": {"eq": false}}
```

There is no default value for `search_params`. To see all available search filters, see the CLI docs.

## `template_hash`

A unique hexadecimal identifier that references a pre-configured template containing all the configuration needed to create instances. Templates are comprehensive specifications that include the Docker image, environment variables, onstart scripts, resource requirements, and other deployment settings.

There is no default value for `template_hash`.

## `template_id`

A numeric (integer) identifier that uniquely references a template in the Vast.ai database. This is an alternative way to reference the same template that `template_hash` points to, but using the template’s database primary key instead of its hash string.

There is no default value for `template_id`.