addis-assistant

# Addis Assistant

## Overview

This skill enables the use of the Addis Assistant API for both Speech-to-Text (STT) and text Translation.

## Using This Skill

This skill provides two primary functions:

1.  **Speech-to-Text (STT):** Convert an audio file (e.g., Amharic) into text.
2.  **Translation:** Translate text from a source language to a target language.

### Authentication

Both functions require an `x-api-key`. This key should be provided as an argument to the respective scripts.

### STT Function

-   **Endpoint:** `api.addisassistant.com/api/v2/stt`
-   **Method:** `POST`
-   **Parameters:**
    -   `audio`: Path to the audio file (e.g., `"@/path/to/file"`)
    -   `request_data`: JSON string with `"language_code": "am"` (Amharic is the default and only supported language for now).

### Translation Function

-   **Endpoint:** `api.addisassistant.com/api/v1/translate`
-   **Method:** `POST`
-   **Parameters:**
    -   `text`: The text to be translated.
    -   `source_language`: The language of the input text (e.g., `"am"`).
    -   `target_language`: The language to translate the text into (e.g., `"en"`).

## Resources

This skill includes `scripts/` for direct execution and `references/` for API details.

### scripts/

-   `stt.py`: Python script for Speech-to-Text.
-   `translate.py`: Python script for text Translation.

### references/

-   `api_spec.md`: Detailed API specifications and curl examples.