Mycroft AI
  • Documentation
  • About Mycroft AI
    • Why use Mycroft AI?
    • Glossary of terms
    • Contributing
    • FAQ
  • Using Mycroft AI
    • Get Mycroft
      • Mark II
        • Mark II Dev Kit
      • Mark 1
      • Picroft
      • Linux
      • Mac OS and Windows with VirtualBox
      • Docker
      • Android
    • Pairing Your Device
    • Basic Commands
    • Installing New Skills
    • Customizations
      • Configuration Manager
      • mycroft.conf
      • Languages
        • Français (French)
        • Deutsch (German)
      • Using a Custom Wake Word
      • Speech-To-Text
      • Text-To-Speech
    • Troubleshooting
      • General Troubleshooting
      • Audio Troubleshooting
      • Wake Word Troubleshooting
      • Log Files
      • Support Skill
      • Getting more support
  • Skill Development
    • Voice User Interface Design Guidelines
      • What can a Skill do?
      • Design Process
      • Voice Assistant Personas
      • Interactions
        • Intents
        • Statements and Prompts
        • Confirmations
      • Conversations
      • Error Handling
      • Example Interaction Script
      • Prototyping
      • Design to Development
    • Development Setup
      • Python Resources
      • Your First Skill
    • Skill Structure
      • Lifecycle Methods
      • Logging
      • Skill Settings
      • Dependencies
        • Manifest.yml
        • Requirements files
      • Filesystem access
      • Skill API
    • Integration Tests
      • Test Steps
      • Scenario Outlines
      • Test Runner
      • Reviewing the Report
      • Adding Custom Steps
      • Old Test System
    • User interaction
      • Intents
        • Padatious Intents
        • Adapt Intents
      • Statements
      • Prompts
      • Parsing Utterances
      • Confirmations
      • Conversational Context
      • Converse
    • Displaying information
      • GUI Framework
      • Show Simple Content
      • Mycroft-GUI on a PC
      • Mark 1 Display
    • Advanced Skill Types
      • Fallback Skill
      • Common Play Framework
      • Common Query Framework
      • Common IoT Framework
    • Mycroft Skills Manager
      • Troubleshooting
    • Marketplace Submission
      • Skills Acceptance Process
        • Information Review Template
        • Code Review Template
        • Functional Review Template
        • Combined Template
      • Skill README.md
    • FAQ
  • Mycroft Technologies
    • Technology Overview
    • Roadmap
    • Mycroft Core
      • MessageBus
      • Message Types
      • Services
        • Enclosure
        • Voice Service
        • Audio Service
        • Skills Service
      • Plugins
        • Audioservice Plugins
        • STT Plugins
        • TTS Plugins
        • Wake Word Plugins
      • Testing
      • Legacy Repo
    • Adapt
      • Adapt Examples
      • Adapt Tutorial
    • Lingua Franca
    • Mimic TTS
      • Mimic 3
      • Mimic 2
      • Mimic 1
      • Mimic Recording Studio
    • Mycroft GUI
      • Remote STT and TTS
    • Mycroft Skills Kit
    • Mycroft Skills Manager
    • Padatious
    • Precise
    • Platforms
Powered by GitBook
On this page
  • Tested Systems
  • Installing Ubuntu in VirtualBox
  • Installing Mycroft
  • Running Mycroft
  • (Optional) SSH Setup

Was this helpful?

  1. Using Mycroft AI
  2. Get Mycroft

Mac OS and Windows with VirtualBox

TL;DR: Get an Ubuntu VM up and running, install alsa and pulseaudio, set up mycroft-core, reboot and enjoy!

PreviousLinuxNextDocker

Last updated 5 years ago

Was this helpful?

Thanks to Mycroft Community Member (Mycroft SysAdmin in a former life) for getting this working!

Tested Systems

Running Mycroft using this method has been tested on:

  • 2017 MacBook Pro running Mojave

  • Lenovo Ideapad 300-15isk running Windows 10

Known issues

So far Mycroft seems to work well on both platforms, although at least two issues have come up with this approach and more may show up as others use this virtualization approach to running Mycroft.

  1. While the TTS (text-to-speech) audio and Spotify audio sounds good the News Skills has issues with playback.

  2. The audio process has crashed unexpectedly, although only once. This can be restarted by running: mycroft-start restart audio

Installing Ubuntu in VirtualBox

  1. Download and install VirtualBox (). You will want to use the latest version (v6.010 and up) as older versions have had audio quality issues.

  2. Open the VirtualBox application and click 'New'

  3. Name the machine, select Linux and Ubuntu (64-bit)

  4. Continue through the rest of the VM configuration screens using the default selections. More RAM would not hurt, but 1GB should be fine.

  5. Download the (18.04 LTS and 19.04 both work) and put it in the folder of the VM you created (e.g. ~/VirtualBox VMs/Mycroft-Ubuntu)

    (Optional) You can install instead of Ubuntu Server if you would like a complete Linux desktop environment, however this is not required to run Mycroft and uses significantly more system resources including RAM.

  6. (Optional) Assign additional CPUs to VM by selecting the System tab at the top and then the Processor tab to select the number of CPUs.

  7. Select the VM you created on the left and click Start!

  8. It will prompt you to select a virtual disk file. Press the folder icon to select the Ubuntu Server ISO downloaded earlier.

  9. Ubuntu will start up and you will have to go through the default setup. Again, defaults should be good the whole way through.

  10. The VM will reboot at the end of the process. To get to login screen you will need to press the enter key a couple times during the boot process. Then login with the credentials you selected during setup.

Congratulations you have a working Ubuntu VM working on MacOS! Now let’s get Mycroft set up.

Installing Mycroft

Run these commands:

  1. sudo apt-get update

  2. sudo apt-get install -y alsa pulseaudio

  3. git clone https://github.com/MycroftAI/mycroft-core.git

  4. cd mycroft-core

  5. ./dev_setup.sh -fm

    This has a few interactive prompts before it begins. A couple minutes in Ubuntu will ask if you want to automatically restart services. You can select Yes. This process may take over an hour if you have only the baseline CPU/RAM allocations.

  6. sudo reboot

Running Mycroft

Now you have a fully operational install of Mycroft.

To start Mycroft run: mycroft-start all

Or to start it and launch the CLI interface: mycroft-start debug

If you chose not to add the executables to $PATH during installation, you can manually run ./start-mycroft.sh from your mycroft-core directory.

(Optional) SSH Setup

If you want to be able to start the VM in headless mode and interact through SSH you will need to add port forwarding to the network configuration. You will also need OpenSSH which can be installed with sudo apt-get install openssh-server.

First get the IP address of the VM with ifconfig | grep inet. Should be 10.0.2.x. Then open the VM settings, go to the Network tab, expand the Advanced section and click the Port Forwarding button. Then enter these settings:

Name: SSH
Protocol: TCP
Host IP: 127.0.0.1
Host Port: 2222
Guest IP: 10.0.2.15 # replace this with the IP address you just obtained
Guest Port: 22

Reboot and VM and you will be able to SSH in with this command: ssh username@localhost -p 2222. You can also select the Start dropdown menu to start the VM in Headless mode.

@arron
https://www.virtualbox.org/
Ubuntu Server ISO
Ubuntu Desktop
Installing Ubuntu in VirtualBox
Installing Mycroft
Running Mycroft