> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simular.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GroundingModel

> A visual-language grounding model that can locate concepts on images.

## Constructor

```typescript
GroundingModel(): GroundingModel
```

### Returns

`GroundingModel`

## Properties

<ResponseField name={"name"} type={"string"} required>
  The wire-level model identifier sent in the request body.
</ResponseField>

## Methods

### availableAliases()

```typescript
availableAliases(): string[]
```

Every VLM model alias accepted by `byAlias` on this machine, deduplicated
and sorted alphabetically. Use to discover what aliases the loaded config
(bundled defaults plus any user provider files advertises.

#### Returns

`string[]`

### byAlias()

```typescript
byAlias(alias: string): GroundingModel
```

Resolve a model alias against the loaded config (e.g. `"ui_venus_30b"`,
`"ui_tars_7b"`, or any alias declared by a user provider). Throws if
the alias is unknown.

#### Parameters

<ResponseField name={"alias"} type={"string"} required />

#### Returns

`GroundingModel`

### default()

```typescript
default(): GroundingModel
```

First VLM model advertised by the first VLM provider in the loaded
config. Throws if no provider in the loaded config advertises a VLM
service.

#### Returns

`GroundingModel`

### ground()

```typescript
ground(target: Screenshot | Image, concept: string): [number, number]
```

Locate `concept` on `target` and return zero-based pixel coordinates
`[x, y]`:

* If `target` is an `Image`, coordinates are in **image-space**.
  Normalized model outputs are scaled linearly onto
  `[0, width - 1]` and `[0, height - 1]`.
* If `target` is a `Screenshot`, coordinates are in **global physical
  screen space** — suitable to feed directly into primitives that
  expect global screen coordinates (e.g. `moveTo`, `clickAt`).

Equivalent to `target.ground(model, concept)`.

#### Parameters

<ResponseField name={"target"} type={"Screenshot | Image"} required />

<ResponseField name={"concept"} type={"string"} required />

#### Returns

`[number, number]`

### uiTars7B()

```typescript
uiTars7B(): GroundingModel
```

Convenience shim for the bundled `ui_tars_7b` alias. Throws if no
provider advertises that alias.

#### Returns

`GroundingModel`

### uiVenus30B()

```typescript
uiVenus30B(): GroundingModel
```

Convenience shim for the bundled `ui_venus_30b` alias. Throws if no
provider advertises that alias.

#### Returns

`GroundingModel`