> For the complete documentation index, see [llms.txt](https://docs.seldon.ai/seldon-enterprise-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.seldon.ai/seldon-enterprise-platform/operations/model-metadata.md).

# Model Metadata

Seldon Enterprise Platform supports the storage and management of model metadata. This includes project name, artifact URI, ML runtime, and prediction schema, amongst other things.

Model metadata is dependent on Postgres. For more information on configuring Postgres with Seldon Enterprise Platform, see [the installation instructions](/seldon-enterprise-platform/production-environment/postgresql.md).

You can create and manage model metadata through the Enterprise Platform UI and API. Enterprise Platform will also watch for deployments in the Kubernetes cluster and sync this information into the metadata store. In this case, the Platform will only populate basic information, but this can then be enriched via the UI and API as with any other model metadata.

## Queries

Seldon Enterprise Platform provides an advanced query language that allows you to make sophisticated search queries over your model metadata.

Simple fields can be compared using SQL-like comparison and partial match operators. Nested fields can be compared by first using index notation to extract simple fields. More complex expressions can be formed with the `AND` and `OR` operators and parentheses. Note that the `AND` and `OR` operators are treated as having equal precedence.

| Operator | Meaning                  |
| -------- | ------------------------ |
| `=`      | Equal                    |
| `!=`     | Not equal                |
| `>`      | Greater than             |
| `<`      | Less than                |
| `>=`     | Greater than or equal to |
| `<=`     | Less than or equal to    |
| `%`      | Like -- partial match    |
| `AND`    | Conjunction              |
| `OR`     | Disjunction              |
| `(...)`  | Subexpression for `...`  |

Field names and operators are not case-sensitive. Field **values** are case-sensitive, however, and should not be wrapped in quotes. The list of valid fields to query is:

| Field name      | Type   | Description                                                                                                                                                                                 |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `URI`           | Simple | String                                                                                                                                                                                      |
| `name`          | Simple | String                                                                                                                                                                                      |
| `version`       | Simple | String, e.g. `1.0`, `v2`, `dev`                                                                                                                                                             |
| `project`       | Simple | String                                                                                                                                                                                      |
| `artifact_type` | Simple | One of `ALIBI_DETECT`, `ALIBI_EXPLAIN`, `CUSTOM`, `HUGGINGFACE`, `MLFLOW`, `MLSERVER_PYTHON`, `ONNX`, `PYTORCH`, `SKLEARN`, `TENSORFLOW`, `TENSORRT`, `TRITON_PYTHON`, `UNKNOWN`, `XGBOOST` |
| `task_type`     | Simple | String, e.g. `classification` or `object-detection`                                                                                                                                         |
| `tags`          | Nested | Map of string to string                                                                                                                                                                     |
| `metrics`       | Nested | Map of string to number                                                                                                                                                                     |

### Examples

```
name % iris

name=iris AND version=2.0

(name=iris AND version=2.0) OR version=3.0

metrics[metricName] > 1.0 AND tags[tagKey] != someValue
```

### API

Using the model metadata API, you can specify a string query the same way you would in the UI, e.g.

```
<yourSeldonDomain>/seldon-deploy/api/v1alpha1/model/metadata?query=(version=1.0)
```