OVOS-config

helper package to interact with the OVOS configuration

Configuration stack

OVOS merges several configuration files into a single configuration. They are loaded in the following order, with later layers overriding earlier ones:

Layer	Path	Written by
`DefaultConfig`	bundled `mycroft.conf`	OVOS (read only)
`DistributionConfig`	`/usr/share/mycroft/mycroft.conf`	distribution/image maintainers (read only)
`SystemConfig`	`/etc/mycroft/mycroft.conf`	system administrators (read only)
`AssistantConfig`	`~/.config/mycroft/runtime.conf`	OVOS itself, at runtime
`UserConfig`	`~/.config/mycroft/mycroft.conf`	the user

So the effective priority is user > assistant > system > distribution > default.

AssistantConfig (runtime.conf) is the place for OVOS components (skills and plugins, e.g. automatic location detection) to persist runtime changes. Keeping these writes out of the user config means OVOS can never accidentally corrupt or overwrite settings the user authored. Use update_assistant_config(config, bus) to write to it programmatically.

Remote configuration (the old Mycroft Home / mycroft.ai backend) has been removed. RemoteConf and the Mycroft*-prefixed config classes remain as deprecated aliases and will be dropped in a future release.

Command Line usage

A small helper tool is included to quickly show, get or set config values

Quick rundown (cli):

ovos-config get
- Loose search (search a key or parts therof):
  
  Given an entry of
```
{'PHAL': {
        'ovos-PHAL-plugin-system': {
                'enabled': True
        },
        'ovos-PHAL-plugin-connectivity-events': {
                'enabled': True
        },
        ... 
}
```
  ovos-config get -k phal would yield all PHAL entries and present it to the user (and the path where they were found)
- Strict search (search keys in a distinct location):
  
  ovos-config get -k /PHAL/ovos-PHAL-plugin-system/enabled
  
  This will output only the value or exit out if no key is found (root slash indicating a strict search)
ovos-config set
- Searches loosely for keys containing the query string and presents a choice to the user to define a value
  
  ovos-config set -k phal
  
  The type is derived from the joined config and thus can be safely cast into the user conf.
  Optionally a value (-v) can be sent as an argument.
ovos-config autoconfigure

ovos-config show
- Get a full table of either the joined, user (-u), system (-s) or assistant (-a) configuration. This can be further refined by passing a --section, which can be listed with ovos-config show -l

Release files for ovos-config 3.6.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ovos-config 3.6.0a1
File	Size	Uploaded
ovos_config-3.6.0a1.tar.gz	50.7 kB	Sep 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ovos-config 3.6.0a1
File	Interpreter	ABI	Platform	Reset
ovos_config-3.6.0a1-py3-none-any.whl 127.3 kB Sep 19, 2026	Python 3	none	any	Details

Total release size: 178.0 kB

Release files / ovos_config-3.6.0a1.tar.gz

Download URL	ovos_config-3.6.0a1.tar.gz
Size	50.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`ed847d97a5f6c032037c909b5a4692b86376bd0413cc0dd731e591e35f5ce808`
BLAKE2b-256 checksum How to use checksums	`e93ecbc53d12605d3eb7f90bd436842fcee5a66c7bb24191c5251da4bb0f301a`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / ovos_config-3.6.0a1-py3-none-any.whl

Download URL	ovos_config-3.6.0a1-py3-none-any.whl
Size	127.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b6faedab9c54e9c9ab88286b1c1097c9c69056c0b370e655c55834936e3664bf`
BLAKE2b-256 checksum How to use checksums	`605ad37680e7cb4e34f6baac5642dd1b6b3d93eff2ae8a7bb88258ca3d75bc9f`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`