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.
Install Termux
Download Termux from F-Droid. The Play Store version is outdated — use F-Droid for the latest build.
Run the Setup
Paste the one-line install command into Termux. It handles everything automatically — packages, Ubuntu, Node.js, the agent, Ollama, and device skills.
Start Using Ruuh
Type ruuh and you're in. Ruuh is ready to help with anything — code, messages, reminders, your phone, your life.
Features
Everything you need for a capable AI assistant that lives on your phone.
One-Command Setup
A single curl command sets up Termux, Ubuntu, Node.js 22, the agent, Ollama, and device skills — everything in one go.
Hybrid AI Backend
Choose cloud APIs (OpenAI, Anthropic) or run models locally via Ollama for offline, private use — no internet required.
Full Ubuntu Environment
Runs in a real Ubuntu instance via proot-distro with Node.js 22 — no root required, no containers, no VMs.
Persistent Memory
MEMORY.md preserves context across sessions. Ruuh remembers what you're working on and picks up where you left off.
Android File Access
Agent configs live in /sdcard/ruuh — edit them from any text editor on your phone. No terminal required for configuration.
Termux API Skills
Ruuh knows how to use your Android hardware — camera, SMS, sensors, location, notifications, and more via auto-discovered Termux API skills.
Run Local with Ollama
Don't want to rely on cloud APIs? Ruuh supports Ollama as a local backend — run models like Llama 3, CodeGemma, and DeepSeek Coder directly on your device. No API keys, no internet, no data leaving your phone.
Switching between cloud and local is a single config change. Point Ruuh at your Ollama instance and it auto-detects available models — no restart required.
Cloud APIs give you the most capable models. Ollama gives you full privacy and offline access. Use whichever fits the moment — or both.
Fully Offline
Run models without an internet connection. Perfect for use on the go or in restricted networks.
Private by Default
Your code never leaves your device. No tokens sent to third-party servers, no usage tracking.
Seamless Switching
Switch between cloud APIs and local models with a single config change. No re-install, no downtime.
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.