akka optimize trained-models register

Register an external base model, adapter, or model weights

Synopsis

Register an external base model, adapter, or model weights from a JSON or YAML descriptor.

The descriptor specifies the serving model configuration:

{ "servingModel": { "variant": "BASE", "baseModel": "Qwen/Qwen3-0.6B" } }

The variant must be BASE, ADAPTER, or WEIGHTS:

  • BASE: Specifies the repository in baseModel and an optional revision commit. If omitted, revision defaults to the repository HEAD at registration time.

  • ADAPTER: Specifies the baseModel, adapterRank, and artifact storage reference.

  • WEIGHTS: Specifies full replacement model weights.

This command outputs a model ID that can be evaluated using "training evaluations start --model". The service derives the model ID from the descriptor, so registering an identical descriptor returns the existing ID.

akka optimize trained-models register -f FILE [flags]

Examples

  # Register a base model descriptor
  akka-optimize trained-models register -f base-model.json

  # Register a base model and immediately start an evaluation
  ID="$(akka-optimize trained-models register -f base-model.json --jq .modelId)"
  akka-optimize training evaluations start --model "$ID" --dataset 4b1c2f9b2ae4

Options

  -f, --file string   Path to the model descriptor file. Use '-' to read from standard input
  -h, --help          help for register

Options inherited from parent commands

      --cache-file string    location of cache file (default "~/.akka/cache.yaml")
      --config string        location of config file (default "~/.akka/config.yaml")
      --context string       configuration context to use
      --disable-prompt       Disable all interactive prompts when running akka commands. If input is required, defaults will be used, or an error will be raised.
                             This is equivalent to setting the environment variable AKKA_DISABLE_PROMPTS to true.
      --force                Skip the confirmation prompt
      --jq string            Filter the JSON output with a jq expression
      --json string          Output JSON with only these fields; --json= lists the fields a command offers
      --no-color             Print without color, as NO_COLOR does
  -o, --output string        set output format to one of [text,json,json-compact,go-template=] (default "text")
      --page-mode string     the mode for paging, either paged, buffered or auto. (default "auto")
  -q, --quiet                set quiet output (helpful when used as part of a script)
      --region string        Region to use if the project has more than one region
      --timeout duration     client command timeout (default 10s)
      --trainer-url string   Trainer service URL (default http://localhost:9001, or TRAINER_URL)
      --url string           Optimize service URL (default http://localhost:9010, or OPTIMIZE_URL)
      --use-grpc-web         use grpc-web when talking to Akka APIs. This is useful when behind corporate firewalls that decrypt traffic but don't support HTTP/2.
      --verbose              set verbose output

SEE ALSO