addis-assistant-stt

---
name: addis-assistant
description: Provides Speech-to-Text (STT) and text Translation using the Addis Assistant API (api.addisassistant.com). Use when the user needs to convert an audio file to text (specifically Amharic), or translate text between languages (e.g., Amharic to English). Requires 'x-api-key'.
---

# 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.