https://github.com/openvoiceos/ovos-docker
Open Voice OS container images and docker-compose.yml files for x86_64 and aarch64 CPU architectures.
https://github.com/openvoiceos/ovos-docker
64-bit aarch64 amd64 arm64 chatgpt compose container docker docker-compose gui mycroft openvoiceos ovos precise-lite raspberry rpi text-to-speech voice-assistant wakeword
Last synced: about 2 months ago
JSON representation
Open Voice OS container images and docker-compose.yml files for x86_64 and aarch64 CPU architectures.
- Host: GitHub
- URL: https://github.com/openvoiceos/ovos-docker
- Owner: OpenVoiceOS
- License: apache-2.0
- Created: 2022-05-07T17:20:53.000Z (almost 4 years ago)
- Default Branch: dev
- Last Pushed: 2026-02-25T06:55:12.000Z (2 months ago)
- Last Synced: 2026-02-25T06:55:24.756Z (2 months ago)
- Topics: 64-bit, aarch64, amd64, arm64, chatgpt, compose, container, docker, docker-compose, gui, mycroft, openvoiceos, ovos, precise-lite, raspberry, rpi, text-to-speech, voice-assistant, wakeword
- Language: Dockerfile
- Homepage: https://openvoiceos.github.io/ovos-docker/
- Size: 10.1 MB
- Stars: 60
- Watchers: 6
- Forks: 20
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Open Voice OS container images
[](https://openvoiceos.com/)
[](https://openvoiceos.github.io/ovos-docker/)
[](https://hub.docker.com/u/smartgic)
[](https://www.debian.org)
[](https://python.org)
[](https://matrix.to/#/#OpenVoiceOS:matrix.org)
[](https://app.codacy.com/gh/OpenVoiceOS/ovos-docker/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[](https://openvoiceos.org/)
## Documentation
Please follow the dedicated [documentation](https://openvoiceos.github.io/ovos-docker/).
## What this repo builds
- Base layers: `ovos-base`, `ovos-sound-base`
- Core runtime: `ovos-core`
- Services: `ovos-audio`, `ovos-cli`, `ovos-listener`, `ovos-messagebus`, `ovos-phal`, `ovos-phal-admin`, `ovos-plugin-ggwave`, `ovos-gui-websocket`
- GUIs: `ovos-gui-original`, `ovos-gui-shell`
- Skills: `ovos-skill-base` plus the default skill images in `docker-bake.hcl`
## Run images
These images run on Docker or Podman. For compose files, audio/GUI setup, and device
mapping examples, follow the documentation.
- Docker: `docker pull docker.io/smartgic/ovos-core:alpha`
- Podman: `podman pull docker.io/smartgic/ovos-core:alpha`
## Build requirements
- Docker with Buildx (BuildKit) available for builds
- Podman works for running images, but builds use Docker Buildx Bake
- Network access to pull base images and dependencies
- Multi-arch builds may require binfmt/qemu; `scripts/bake.sh` can install it via
`tonistiigi/binfmt` (set `ENSURE_BINFMT=true` or use `--ensure-binfmt`)
## Build images
Builds are handled via Docker Buildx Bake (`docker-bake.hcl` and `scripts/bake.sh`).
Direct `docker build` usage is not supported because base image wiring relies on
Bake contexts.
### Quick examples
- Local build (amd64 only, loads to local Docker): `./scripts/bake.sh --load --no-push`
- Multi-arch publish (default registry/tag): `./scripts/bake.sh`
- Multi-arch alpha publish: `TAG=alpha CHANNEL=alpha VERSION=alpha PLATFORMS=linux/amd64,linux/arm64 ./scripts/bake.sh`
- Build a subset: `./scripts/bake.sh -T stack` or `./scripts/bake.sh -T skills`
- Disable registry cache: `./scripts/bake.sh --no-cache-from --load --no-push`
- Note: `--load` forces `linux/amd64` because Docker cannot load multi-arch manifests locally.
### Targets
- Groups: `default`, `stack`, `services`, `skills`, `guis`
- Individual targets are defined in `docker-bake.hcl`
### Configuration
Defaults are defined in `docker-bake.hcl` and `scripts/bake.sh`:
- `REGISTRY` (default `docker.io/smartgic`)
- `TAG` and `VERSION` (default `alpha`)
- `LATEST_TAG` (default `latest`, only applied when `TAG=stable`)
- `CHANNEL` (default `alpha`, used for constraints files)
- `PLATFORMS` (default `linux/amd64,linux/arm64`)
- `UV_PRERELEASE` (default `allow`)
- `ENSURE_BINFMT` (default `auto`, set `true` to force or `false` to skip)
- `BUILDER` (default `ovos-bake`)
Examples:
- `REGISTRY=docker.io/smartgic TAG=alpha CHANNEL=alpha ./scripts/bake.sh`
- `TAG=stable CHANNEL=stable ./scripts/bake.sh -T services`
## Support
- [Matrix channel](https://matrix.to/#/#openvoiceos:matrix.org)
- [Contribute to Open Voice OS](https://openvoiceos.github.io/community-docs/contributing/)
- [Report bugs related to these Docker images](https://github.com/OpenVoiceOS/ovos-docker/issues)