Skip to content

Configuration

Micro-Seg reads one TOML file on startup:

  • Windows: %APPDATA%/MicroSeg/microseg.toml
  • Linux: ~/.config/MicroSeg/microseg.toml

Precedence: environment overrides → microseg.toml → built-in defaults. The file must declare schema_version = 1.

Key Values Notes
theme System · Light · Dark · Cvat also switchable by clicking the top-bar logo
default_export_format Json · Coco · Yolo annotation export format
auto_save_interval_ms integer 0 disables auto-save
max_recent_projects integer ≥ 1

enabled = true activates AI features. Models come from a model catalog: active_model_id selects an entry from [[ai.models]].

Each catalog entry has an id, a display name and a backend:

  • local_ort — an ONNX model run locally: model_path, model_type (HRNetOCR | MobileNetV2), threshold (0–1), with_prev_mask, optional infer_size / max_size.
  • remote_nuclio — inference delegated to a Nuclio function (e.g. a SAM deployment): platform_url, function_namespace, function_name, invoke_url. For teams with a shared GPU box; everything else stays local.
schema_version = 1
[ai]
enabled = true
active_model_id = "hrnet-local"
[[ai.models]]
id = "hrnet-local"
name = "HRNet-OCR (local)"
backend = "local_ort"
model_path = 'C:/models/HRNetOCR.onnx'
model_type = "HRNetOCR"
threshold = 0.5
with_prev_mask = true

If the configured model path is invalid, AI is disabled at runtime instead of failing the app.

Key Meaning
enabled global gate for the plugin runtime
enabled_plugins allowlist of plugin ids — empty means none run
user_params per-plugin parameter overrides (secrets live here, never in project files)

Per-project plugin bindings live in <project_root>/.microseg/plugins.json — see Plugins.

  • [onnx].dylib_path points at the ONNX Runtime library (onnxruntime.dll / libonnxruntime.so); invalid values fall back to the built-in search. The ORT_DYLIB_PATH environment variable overrides it.
  • MICROSEG_PLUGIN_HOST_STDIO controls plugin-host output: none (default), inherit (attach to your terminal — useful when debugging a plugin), or file (capture to log files under the config directory).