Ruuh — Your Personal AI Agent on Android
A personal AI assistant that lives on your Android device — chat, code, control your phone, and automate your life. Powered by cloud APIs or local models via Ollama. One command to install.
curl -fsSL https://raw.githubusercontent.com/perminder-klair/ruuh/main/scripts/setup.sh | bashWhat is Ruuh?
Ruuh is a personal AI assistant powered by the pi-coding-agent npm package. It runs inside a full Ubuntu environment on your Android device via Termux and proot-distro — no root required. Connect to cloud APIs like OpenAI and Anthropic, or run models locally with Ollama for fully offline use.
It remembers context across sessions, follows custom instructions you define, and can access your Android's file system so you can edit configs from any text editor on your phone.
Think of it as having a sharp, thoughtful personal assistant in your pocket — one that actually listens, remembers, and gets better over time.
How It Works
Three steps. Five minutes. No root access required.
Run the Setup
Paste the one-line install command into Termux. It handles everything automatically.
Start Using Ruuh
Type ruuh and you're in. Ruuh is ready — messages, reminders, your phone, your life.
Features
Everything you need for a capable AI assistant that lives on your phone.
Run Local with Ollama
Run models like Qwen 3, GLM-5, and Kimi K2.5 directly on your device via Ollama — no API keys, no internet, no data leaving your phone.
Persistent Memory
Persistent memory preserves context across sessions. Ruuh remembers what you're working on and picks up where you left off.
Run on Any Android
Works on any Android 7+ phone or tablet. No root required — runs in a full Ubuntu environment via Termux and proot-distro.
Termux API Skills
Ruuh knows how to use your Android hardware — camera, SMS, sensors, location, notifications, and more via auto-discovered Termux API skills.
Web Dashboard
Monitor and chat with Ruuh from any browser on your network. A real-time PWA dashboard with live status, activity logs, and a full chat interface — installable to your home screen.
Extensible Skill System
Extend Ruuh with skills from clawhub.ai — a growing library of community skills for weather, summarization, and more. Skills auto-discover on startup and use minimal tokens.
Android Device Skills
Ruuh can interact with your Android hardware through Termux API skills. Send SMS, take photos, check battery, read sensors, show notifications, record audio, and more — all through natural conversation with your agent.
Skills are auto-discovered when Ruuh starts. Install them with a single command and Ruuh immediately knows how to use every Termux API command on your device.
Requires the Termux:API companion app installed from F-Droid for hardware access. Both Termux and Termux:API must be installed from F-Droid — mixing Play Store and F-Droid versions causes signature mismatch errors.
curl -fsSL https://raw.githubusercontent.com/perminder-klair/ruuh/main/scripts/skills-setup.sh | bashDevice & Sensors
Battery status, brightness, torch, vibrate, volume, sensors, fingerprint, GPS location, WiFi, clipboard, notifications, dialogs, toasts, wake lock, wallpaper, and downloads.
Comms & Media
SMS send & receive, contacts, call log, camera photos, microphone recording, text-to-speech, media playback, file sharing, storage picker, and calendar access.
System & Automation
Job scheduling, infrared transmit, USB device access, NFC tag read/write, and hardware keystore crypto.