Metadata-Version: 2.4
Name: ovos-skill-wolfie
Version: 0.6.0a1
Summary: ovos wolfram alpha skill plugin
Author-email: JarbasAi <jarbasai@mailfence.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/OpenVoiceOS/ovos-skill-wolfie
Keywords: ovos,skill,plugin,wolfram
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ovos-utils<1.0.0,>=0.7.0
Requires-Dist: ovos-workshop<9.0.0,>=8.0.0
Requires-Dist: ovos-wolfram-alpha-plugin<2.0.0,>=1.0.0a1
Dynamic: license-file

# ovos-skill-wolfie

[![PyPI](https://img.shields.io/pypi/v/ovos-skill-wolfie)](https://pypi.org/project/ovos-skill-wolfie/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
[![Python](https://img.shields.io/badge/python-%3E%3D3.10-blue)](https://www.python.org/)

Wolfram Alpha skill for [OpenVoiceOS](https://openvoiceos.org). Adds a voice interface on top of [ovos-wolfram-alpha-plugin](https://github.com/OpenVoiceOS/ovos-wolfram-alpha-plugin), which handles all Wolfram Alpha queries.

Supports three answer modes:

- **Explicit intent** — handles utterances that target Wolfram Alpha directly (e.g. "ask the wolf what is the speed of light"). These always go to this skill.
- **Common Query** — handles general knowledge questions (e.g. "how tall is Mount Everest?") via the [OVOS Common Query pipeline](https://github.com/OpenVoiceOS/ovos-common-query-pipeline-plugin). The pipeline asks all registered knowledge skills and picks the best answer.
- **Fallback** — if no other skill or pipeline handler answers, Wolfram Alpha gets a last shot before the "I don't understand" response.

---

## Installation

```bash
pip install ovos-skill-wolfie
```

An [API key](https://products.wolframalpha.com/api/) is required. Configure it in the skill settings:

```json
{
  "appid": "YOUR-WOLFRAM-API-KEY"
}
```

---

## Explicit intent utterances

These always route to this skill because they name Wolfram or "the wolf" explicitly:

- "Ask the wolf what is the speed of light"
- "Ask Wolfram Alpha about the population of Japan"
- "Search Wolfram for the boiling point of ethanol"
- "What does Wolfram say about the Eiffel Tower?"

## Common Query utterances

These go through the pipeline — Wolfram answers if it wins:

- "How tall is Mount Everest?"
- "What's 18 times 4?"
- "How many inches in a meter?"
- "When was The Rocky Horror Picture Show released?"
- "What is Madonna's real name?"

---

## Common Query pipeline

When the [Common Query pipeline plugin](https://github.com/OpenVoiceOS/ovos-common-query-pipeline-plugin) is active, this skill competes against other knowledge skills (e.g. Wikipedia, WordNet) to answer general questions. The pipeline selects the response with the highest confidence score.

---

## Fallback

This skill also registers as a fallback handler at priority 91. If no intent or pipeline handler answers an utterance, Wolfram Alpha gets a last chance to respond before OVOS speaks "I don't know".

---

## License

Apache 2.0 — see [LICENSE](LICENSE).
