AndroMate

KO | EN

gitlite — search

#hacktoberfest #react #ai #golang #go #android #deep-learning #macos #nodejs #awesome #cli #awesome-list #mcp #openai

(★ 24)

A voice‑controlled AI assistant for Termux on Android.

AndroMate 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="img/img.png" alt="AndroMate Logo" width="200"/>
 
 <h1 align="center">AndroMate</h1>
 
 
 Your AI-powered Android assistant — chat, call, text, control. 
 Natural language, voice commands, Telegram, web dashboard, or the interactive CLI.

---

## Table of Contents

- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [CLI Commands](#cli-commands)
- [Provider Management](#provider-management)
- [Telegram Bot](#telegram-bot)
- [Web Dashboard](#web-dashboard)
- [Configuration](#configuration)
- [Project Structure](#project-structure)
- [Contributing](CONTRIBUTING.md)
- [License](#license)

---

## Screenshots

| CLI | Telegram Bot |
|:---:|:---:|
| ![CLI](https://raw.githubusercontent.com/Anon4You/AndroMate/main/img/cli_screenshot.jpg) | ![Telegram](https://raw.githubusercontent.com/Anon4You/AndroMate/main/img/telegram_screeshot.jpg) |

---

## Features

### Core
- **Multi-Provider AI** — Use any OpenAI-compatible API: OpenAI, OpenRouter, Ollama, LM Studio, vLLM, Groq, Together, and more
- **Unified `/provider` command** — Arrow-key menus with type-to-filter for managing providers (add/edit/remove/switch/test)
- **`/telegram` command** — Manage bot token and chat ID from the CLI
- **`/email` command** — Configure email sender and app password from the CLI
- **Rich CLI** — Claude Code-style terminal interface with syntax highlighting, markdown rendering, and prompt bars
- **Web Dashboard** — Modern browser-based chat and provider management UI
- **Native Voice Recognition** — Hands-free control via `termux-speech-to-text`
- **Spoken Feedback** — Uses `termux-tts-speak` for audible confirmations

### Device Control
- **SMS & Calls** — Send SMS, view call logs with contact names, make calls
- **Email** — Send background emails via SMTP (Gmail supported)
- **WhatsApp** — Send messages via `wacli` CLI tool
- **Contacts** — List and search contacts with fuzzy matching
- **System** — Execute shell commands, control brightness, volume, battery
- **Camera** — Take selfies and photos
- **Connectivity** — Toggle WiFi, scan networks, get connection info

### Remote Control
- **Telegram Bot** — Full device control from anywhere — natural language chat works without `/ai`
- **Web Dashboard** — Browser-based chat and provider management, mobile-friendly

---

## Requirements

### System Packages

### Python Libraries
```bash
pip install requests rich prompt_toolkit pyfiglet telebot SpeechRecognition colorama flask pyaudio
```

> [!WARNING]
> After installing Termux:API, run commands like `termux-sms-list` and `termux-call-log` once manually to grant Android permissions.

---

## Installation

1. **Clone the repo**
   ```bash
   git clone https://github.com/Anon4You/AndroMate.git
   cd AndroMate
   ```

2. **Run the installer**
   ```bash
   bash install.sh
   ```

3. **Grant Termux permissions** (run once)
   ```bash
   termux-microphone-record    # Voice commands
   termux-sms-list             # SMS features
   termux-call-log             # Call logs
   termux-location             # Location services
   ```

4. **Add an AI provider**
   ```bash
   python andromate.py
   /provider                   # Opens the provider manager
   ```
   Any OpenAI-compatible API works. No API key needed for Ollama running locally.

5. **Run**
   ```bash
   python andromate.py          # CLI (default)
   python andromate.py voice    # Voice mode
   python andromate.py telegram # Telegram bot
   python andromate.py web      # Web dashboard
   ```

---

## Usage

---

## CLI Commands

Type `?` for keyboard shortcuts.

### Keyboard Shortcuts

---

## Provider Management

The `/provider` command opens an arrow-key menu with all provider operations:

- **List** — View all configured providers and which is active
- **Switch Active** — Change the active provider (arrow keys)
- **Add** — Add from presets (OpenRouter, OpenAI, Ollama, LM Studio, Groq, Together, etc.) or custom
- **Edit** — Change model and API key (arrow-key model selection from presets)
- **Remove** — Delete a provider
- **Test** — Verify API connectivity

All selectors support **type-to-filter** — just start typing to narrow down the list.

### Supported Presets

---

## Telegram Bot

Control AndroMate remotely via Telegram. Just send any message — no `/ai` prefix needed.

1. Create a bot with [@BotFather](https://t.me/botfather)
2. Get your chat ID (message [@userinfobot](https://t.me/userinfobot))
3. Configure in the CLI:
   ```
   /telegram
   ```
4. Run: `python andromate.py telegram`

### Bot Commands

Just type any natural language message to chat with AI — it handles both conversation and device actions automatically.

> [!TIP]
> Keep the bot running in the background with `tmux`:
> ```bash
> tmux new -s andromate
> python andromate.py telegram
> # Detach: Ctrl+B, then D
> # Reattach: tmux attach -t andromate
> ```

---

## Web Dashboard

A modern browser-based interface for chat and provider management.

```bash
python andromate.py web
# Opens on http://localhost:5000
```

### Features
- **Chat tab** — Full conversation with markdown rendering, code blocks, image display
- **Providers tab** — Card grid showing all providers with model, endpoint, key status
- **Provider management** — Add/edit/remove/test/switch active providers
- **Mobile responsive** — Bottom navigation bar, stacked cards on small screens
- **Settings** — Auto-scroll, save history, enter-to-send toggles
- **Theme** — Dark/light mode toggle
- **Import/Export** — Save and restore chat history

---

## Configuration

Config is stored at `~/.andromate/config.json` (auto-generated on first run).

### Config Keys

### Email Setup

Use the CLI command `/email` or edit config directly:
```json
{
  "email_sender": "your.email@gmail.com",
  "email_app_password": "your-16-char-app-password"
}
```

> [!CAUTION]
> Never use your regular Google password. Generate an App Password at myaccount.google.com/apppasswords.

---

## Project Structure

```
AndroMate/
├── andromate.py              # Main entry point
├── install.sh                # Installer script
└── modules/
    ├── __init__.py
    ├── actions.py            # Device actions (SMS, Call, Email, Camera, Shell)
    ├── ai.py                 # AI decision routing
    ├── cli.py                # Rich CLI with slash commands
    ├── config.py             # Multi-provider configuration management
    ├── memory.py             # Conversation history
    ├── prompt_manager.py     # Dynamic AI prompt generation
    ├── providers.py          # Provider wrappers (OpenAI-compatible)
    ├── telegram_bot.py       # Telegram bot interface
    ├── web_dashboard.py      # Flask web dashboard server
    ├── utils.py              # Helpers (TTS, contacts)
    ├── static/
    │   └── style.css         # Dashboard styles
    └── templates/
        └── dashboard.html    # Dashboard template
```

---

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

---

## License

This project is licensed under the **MIT License**. See [LICENSE](LICENSE).

---

Developed by <a href="https://github.com/Anon4You">Anon4You</a>

AndroMate

AndroMate 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

AndroMate

AndroMate 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README