Metadata-Version: 2.4
Name: myra-termux
Version: 0.2.0
Summary: MYRA AI assistant for Termux (Android) and Linux: chat, voice, 148+ languages and device control via Gemini
License: Proprietary
Keywords: termux,android,assistant,gemini,voice,myra
Classifier: Environment :: Console
Classifier: Operating System :: Android
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# MYRA for Termux & Linux

MYRA AI assistant for your Android phone ([Termux](https://termux.dev)) and Linux computers. Powered by Google Gemini.
Chat or talk in **148+ languages**, and let MYRA control your device.

- **Termux (Android):** torch, battery, SMS, calls, apps, volume, brightness, clipboard, location, URLs, voice in/out.
- **Linux:** battery, notifications, open apps/URLs, volume (`pactl`), brightness (`brightnessctl`), clipboard (`xclip`/`wl-clipboard`), spoken replies (`espeak-ng`).

## Install

```
pkg update && pkg install python termux-api
pip install myra-termux
myra-termux --setup
myra-termux
```

Also install the **Termux:API** app (F-Droid) for phone control and voice.

Get a free Gemini API key at https://aistudio.google.com/apikey

## Install on Linux

```
sudo apt install python3-pip xclip libnotify-bin espeak-ng   # optional helpers
pip install myra-termux        # (use `pipx install myra-termux` on newer distros)
myra-linux --setup
myra-linux
```

`myra-linux` and `myra-termux` are the same program; the backend is detected automatically (override with `MYRA_BACKEND=linux|termux`).

## Update

```
pip install --upgrade myra-termux
```

## Usage

| Command | What it does |
|---|---|
| `myra-termux` | Chat mode |
| `myra-termux --voice` | Speak and listen (Termux:API) |
| `myra-termux --language Tamil` | Set language (any of 148+; `auto` = Hinglish) |
| `myra-termux --languages` | List all languages |
| `myra-termux --name Rahul` | Set your name |
| `myra-termux --ask "battery kitni hai?"` | One-shot question |

You can also say it naturally: "speak Spanish", "tamil me bolo", "mera naam Rahul hai", "torch on karo", "mummy ko SMS bhejo".

SMS and calls always ask for your confirmation first.

## Notes

- Your API key is stored in `~/.myra_termux/config.json` (user-only permissions). Env var `GEMINI_API_KEY` also works.
- Voice quality varies by language; big languages (Hindi, English, Spanish, Japanese, Tamil...) are best.
- This package is pure Python with no dependencies.
