# Using Mycroft AI

- [Get Mycroft](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft.md): Want to give Mycroft a try? Mycroft is open source software that runs where you want it to, whether it’s on your own hardware or one of our dedicated devices.
- [Mark II](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/mark-ii.md): The Mark II is our next-generation smart speaker designed for you and your family, whatever your level of technical expertise. The Dev Kit is open hardware and software to enable development.
- [Mark II Dev Kit](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/mark-ii/mark-ii-dev-kit.md): The Mark II Dev Kit is intended for Software Developers and Hardware Developers to develop on the Mycroft platform.
- [Mark 1](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/mark-1.md): The Mark 1 device is an Enclosure for Mycroft, based on Raspberry Pi. It is designed as a reference hardware device, and is able to be easily modified, hacked and extended.
- [Picroft](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/picroft.md): Picroft is a ready-made way to run Mycroft on a Raspberry Pi 3, 3B+ or 4 and is provided as a disk image that you can burn to a Micro SD card.
- [Linux](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/linux.md): Install Mycroft on Linux, learn how to start and stop services, configure proxies, or remove Mycroft from your system.
- [Mac OS and Windows with VirtualBox](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/macos-and-windows-with-virtualbox.md): TL;DR: Get an Ubuntu VM up and running, install alsa and pulseaudio, set up mycroft-core, reboot and enjoy!
- [Docker](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/docker.md): Learn how to install Mycroft for Docker either from a Docker Hub install, or by building the image. Many thanks to Brian Hopkins (@btotharye) for this documentation.
- [Android](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/get-mycroft/android.md): Mycroft for Android is a Community led project. It is a proof of concept and is not ready for general use. There is no .apk available.
- [Pairing Your Device](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/pairing-your-device.md): Pairing makes information available to your Device to personalise your experience, such as which units of measurement you prefer, and your general location.
- [Basic Commands](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/basic-commands.md): Now that your Mycroft Device is Paired with home.mycroft.ai, you may begin issuing commands. Try these to get started.
- [Installing New Skills](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/installing-new-skills.md): Skills are like apps for a voice assistant. They give Mycroft access to new information and new abilities.
- [Customizations](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations.md)
- [Configuration Manager](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/config-manager.md): The mycroft-config utility simplifies management of the the various configuration files that control Mycroft. Commands include: edit, show, get, set, reload.
- [mycroft.conf](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/mycroft-conf.md): A configuration file that contains the device and service settings.
- [Languages](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/languages.md): Learn about foreign language support in Mycroft, and how to approach configuring Mycroft to support other languages.
- [Français (French)](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/languages/francais-french.md): How to configure Mycroft for use in French.
- [Deutsch (German)](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/languages/german.md): Dies ist eine Anleitung wie Mycroft in Deutsch eingerichtet werden kann. Diese Seite beinhaltet auch eine Kurzanleitung.
- [Using a Custom Wake Word](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/wake-word.md): You might want to change the Wake Word to a phrase that's easier for you to speak, is more culturally appropriate, or just more personal and fun for you.
- [Speech-To-Text](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/stt-engine.md): Speech-To-Text (STT) is the process of converting audio of spoken words into strings of text. Mycroft supports a range of Speech-To-Text engines.
- [Text-To-Speech](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/customizations/tts-engine.md): Text-To-Speech (TTS) is the process of synthesizing audio from text. Mycroft uses our own TTS engines by default, however we also support a range of third party services.
- [Troubleshooting](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/troubleshooting.md): Having trouble with Mycroft? Here are solutions to common problems, and ways to get further support.
- [General Troubleshooting](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/troubleshooting/general-troubleshooting.md): Troubleshooting tips and tricks
- [Audio Troubleshooting](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/troubleshooting/audio-troubleshooting.md): Having trouble with your audio?
- [Wake Word Troubleshooting](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/troubleshooting/wake-word-troubleshooting.md): Having trouble triggering the wake word?
- [Log Files](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/troubleshooting/log-files.md): Information on the different log files Mycroft uses, where the logs files are located on a Mycroft Device, the sort of data that you will find in them, and some common commands to use to aid diagnosis
- [Support Skill](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/troubleshooting/support-skill.md): The easiest way to find out what's happening on your device.
- [Getting more support](https://mycroft-ai.gitbook.io/docs/using-mycroft-ai/troubleshooting/getting-more-support.md): I've tried everything! Where to get further support.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mycroft-ai.gitbook.io/docs/using-mycroft-ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
