MycroftAI
/
mycroft-core
mirror of https://github.com/MycroftAI/mycroft-core.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
21 Commits
68 Branches
134 Tags
290 MiB
Python 92.7%
Shell 5.8%
QML 1.3%
Dockerfile 0.2%
 
 
 
 
Go to file
Arron Atchison 81ab26739b Edited the readme a bit more; formatting is bad 2016-05-23 14:51:30 -05:00
doc Issues-4 - Fix pep8 errors. 2016-05-23 17:23:47 +00:00
mycroft Issues-4 - Fix pep8 errors. 2016-05-23 17:23:47 +00:00
publish In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
test Issues-4 - Fix pep8 errors. 2016-05-23 17:23:47 +00:00
.gitignore Adding .gitignore 2016-05-20 15:28:20 -04:00
.travis.yml Issues-4 - Fix pep8 errors. 2016-05-23 17:23:47 +00:00
CONTRIBUTING.md In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
LICENSE.md In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
README.md Edited the readme a bit more; formatting is bad 2016-05-23 14:51:30 -05:00
build_host_setup.sh https://github.com/MycroftAI/mycroft-core/issues/31 2016-05-23 14:43:06 -05:00
dev_setup.sh Install mimic in dev_setup.sh 2016-05-21 17:40:00 +02:00
install-mimic.sh In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
install-pygtk.sh In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
mycroft-base-MANIFEST.in In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
mycroft-base-setup.py Issues-4 - Fix pep8 errors. 2016-05-23 17:23:47 +00:00
requirements.txt added pep8 to requirements.txt 2016-05-23 14:24:03 -05:00
skills-sdk-MANIFEST.in In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
skills-sdk-setup.py Issues-4 - Fix pep8 errors. 2016-05-23 17:23:47 +00:00
start.sh In the 1970s computer users had to understand the arcane syntax of the machines they used. They programed their computers using the machine's native language and hardly gave it a thought. 2016-05-20 09:16:01 -05:00
test-requirements.txt Issues-4 - Fix pep8 errors. 2016-05-23 17:23:47 +00:00

README.md

Mycroft

Full docs at: https://docs.mycroft.ai

Pair Mycroft instance with Cerberus Account Management Service: https://cerberus.mycroft.ai

Getting Started in Ubuntu - Development Environment

  • Install virtualenv >= 13.1.2 and virtualenvwrapper (Restart session)
  • Install the following native packages
    • libtool
    • autoconf
    • bison
    • swig
    • libglib2.0-dev
    • portaudio19-dev
    • python-dev
    • curl
    • mpg123
    • espeak

In addition, if you are running Ubuntu 16.04 or another O/S

  • Install:

    • libffi-dev
    • libssl-dev

  • run dev_setup.sh (feel free to read it, as well)

  • Restart session (reboot computer, or logging out and back in might work).

Cerberus Device and Account Manager

Mycroft AI, Inc. - the company behind Mycroft maintains the Cerberus device and account management system. Developers can sign up at https://cerberus.mycroft.ai

By default the Mycroft software is configured to use Cerberus, upon any request such as "Hey Mycroft, what is the weather?", you will be informed that you need to pair and Mycroft will speak a 6-digit code, which you enter into the pairing page on the Cerberus site.

Once signed and a device is paired, the unit will use our API keys for services, such as the STT (Speech-to-Text) API. It also uses allows you to use our API keys for weather, Wolfram-Alpha, and various other skills.

Pairing information generated by registering with Cerberus is stored in:

~./mycroft/identity/identity.json <-- DO NOT SHARE THIS WITH OTHERS!

It's useful to know the location of the identity file when troubleshooting device pairing issues.

Using Mycroft without Cerberus.

If you do not wish to use our service, you may insert your own API keys into the configuration files listed below in configuraion.

The place to insert the API key looks like the following:

[WeatherSkill]

api_key = ""

Put the relevant key in between the quotes and Mycroft Core should begin to use the key immediately.

API Key services

These are the keys currently in use in Mycroft Core.

Configuration

Mycroft configuration consists of 3 possible config files.

  • defaults.ini, which lives inside the mycroft codebase/distribution
  • /etc/mycroft/mycroft.ini
  • $HOME/.mycroft/mycroft.ini

When the configuration loader starts, it looks in those locations in that order, and loads ALL configuration. Keys that exist in multiple config files will be overridden by the last file to contain that config value. This results in a minimal amount of config being written for a specific device/user, without modifying the distribution files.

Starting the Virtualenv

To ensure that you are in the Mycroft virtualenv before trying to start the services, as everything is installed there, Run:

workon mycroft

Running the initial stack

  • run PYTHONPATH=. python client/speech/main.py # the main speech detection loop, which prints events to stdout and broadcasts them to a message bus
  • run PYTHONPATH=. python client/messagebus/service/main.py # the main message bus, implemented via web sockets
  • run PYTHONPATH=. python client/skills/main.py # main skills executable, loads all skills under skills dir

Running stack via the script

  • run ./start.sh service
  • run ./start.sh skills
  • run ./start.sh voice