autoscientist

Recommend hyperparameters

Changed on

Returns the hyperparameters AutoScientist derives for a model and the dataset's effective training size (rows plus planned augmentation). Nothing is launched. Omit model to size against the model POST /autoscientist would select for this dataset; the resolved id is returned with the values. POST /autoscientist applies the same values when hyperparams is omitted.

post/api/v1/autoscientist/recommend-hyperparams

Request

Request body

dataset_idstring required

The dataset the hyperparameters are sized for. Must be a dataset you own that has finished processing.

modelstring

Base model id from GET /autoscientist/models to tune for. Omit to size the recommendation against the model POST /autoscientist selects for this dataset; the resolved id is returned in the response model field. That pick assumes no column_mapping, so a create request supplying column_mapping.reasoning_trace can resolve a different model. Pass the returned model back on create to pin it.

augmentation_domain_rowsnumber

Number of synthetic domain-targeted rows you plan to generate. These are additional to your own rows and count toward the effective training size, so the recommendation matches what you will launch. Defaults to 0 (no augmentation).

augmentation_general_rowsnumber

Number of synthetic general-diversity rows you plan to generate. These are additional to your own rows and count toward the effective training size. Defaults to 0 (no augmentation).

Response

modelstring required

Resolved base model id the recommendation is sized for: the value you sent, or the automatically selected model when model was omitted. Pass it back as model on POST /autoscientist to launch against the same model.

Example response

{
  "hyperparams": {
    "n_epochs": 1,
    "learning_rate": 0.00005,
    "lora_r": 8,
    "lora_trainable_modules": "q_proj,v_proj",
    "min_lr_ratio": 0.1,
    "scheduler_num_cycles": 0.5,
    "warmup_ratio": 0.03,
    "max_grad_norm": 2,
    "dpo_beta": 0.1
  }
}

Changes

    • info

      removed the constant enum value from the ///// response property for the response status

    • info

      the response's property default value 0 was added for the status

    • info

      the response's property default value 0.5 was added for the status

    • info

      the response's property default value 0 was added for the status