Skip to content

Latest commit

 

History

History
85 lines (57 loc) · 4.54 KB

README.md

File metadata and controls

85 lines (57 loc) · 4.54 KB

Almond for GNOME

Build Status Dependency Status Language grade: JavaScript Discord Discourse status

An Open Virtual Assistant

This repository contains the GNOME/Gtk platform integration layer for the Almond Open Virtual Assistant.

Almond is a Virtual Assistant that lets you connect to multiple services and devices, while respecting your privacy. Almond is also the only assistant that supports compound commands, using a powerful experimental deep-learning semantic parser. (What are compound commands?)

Almond comes in various form:

  • As a phone app, for Android
  • As an installable app for a home server
  • As a web service hosted at https://almond.stanford.edu
  • A GTK+/GNOME app for desktops (this repository)

Almond is a research project led bf prof. Monica Lam, in the Stanford University Open Virtual Assistant Lab. You can find more information at https://almond.stanford.edu.

Installation

Flatpak

Flatpak is the recommended way to install Almond. The latest stable version is available on Flathub.

To install the latest development version of Almond, use:

flatpak remote-add almond-nightly --from https://flatpak.almond.stanford.edu/almond-nightly.flatpakrepo
flatpak install edu.stanford.Almond//master

Building from Source

To build Almond from source, you should use flatpak-builder:

flatpak-builder --install --install-deps-from=flathub _app edu.stanford.Almond.json

This will automatically build and install all the dependencies, and install the Almond app.

Alternatively, you can use GNOME Builder as the IDE. GNOME Builder has native support for flatpaks. Opening the cloned repository with GNOME Builder will allow you to build and run Almond by pressing "play".

NOTE: the first build of the app can be very long, as it needs to build all the dependencies (in particular cvc4, nodejs, scipy and tensorflow). For the master branch, we provide cached binaries at https://flatpak.almond.stanford.edu/build-cache.tar.gz; unpack these in the checkout directory (it will create a single directory called .flatpak-builder) before invoking flatpak-builder.

Usage

Almond is a virtual assistant: it takes natural language commands, interprets them, and displays the result. The set of supported commands is defined in Thingpedia, and roughly covers web services, news services, and some Internet-of-Things devices.

Voice support is available as well: once opened the first time, an always listening background service can recognize voice input and reply. The default hotword is "Almond". You can disable voice input or voice output from the app settings.

Additional user documentation is available on the Almond website.

NOTE: Almond uses Genie for its natural language understanding component. Genie is an experimental deep-learning based semantic parsing toolkit. While it can understand a much larger space of commands, including notifications and complex queries, it can also behave erratically if you type commands that are not in Thingpedia. Please avoid "chatting" with Almond, it will only lead to frustration.

Contributing

Have you found a bug? A new feature? A better voice model? More skills? Almond welcomes your help! Please look at the contribution guide for details, and don't hesitate to reach out to us on our community forum.

License

Almond is free software, and is distributed under the Apache 2.0 license. See LICENSE for details.

Additionally, Almond contains a GNOME Shell extension, included in the "shell-extension" folder. That code, and only that code, is licensed under the GNU General Public License, version 2 or later.