ADAPTIVE REASONING & INTELLIGENCE ASSISTANT

Not an
assistant.
A presence.

ARA lives on your Android device and connects to your Arch Linux desktop. Voice commands, job applications, social media, email, security scans, traditional healing, numerology — all through one interface.

05:45 📶 🔋
💬
🧩
📱
🕐
⚙️
A
ARIA
pollinations • gemini
Open WhatsApp
Opening WhatsApp.
🔧 ✓ WhatsApp opened
Run security scan
Running now. You'll be notified instantly if something's off.
🔧 ✓ Security: All Clear
Post about my SaaS on all socials
Generating caption
🎤
Message ARA…
💼

Job Applications

Searches Indeed, PNet, CareerJunction. Easy Apply and email-apply only. Drafts cover letters from your CV.

📱

App Control

Opens, launches, and interacts with 60+ installed apps by name. Scans what's installed automatically.

📣

Social Media

Generates optimised captions and posts to Instagram, Reddit, X, TikTok, LinkedIn — all at once.

💻

Linux Desktop

Full shell access on your Arch machine over WebSocket. Open apps, run commands, close browser tabs.

📧

Email

Reads your inbox, drafts replies, copies to clipboard. You approve before anything sends.

🛡️

Security

Scans installed packages for suspicious patterns, checks network state, notifies instantly on threats.

🌿

Traditional Healer

Ubulumko — Isangoma & Inyanga wisdom. Ancestral diagnosis, muthi, tri-colour healing system.

🔢

Numerologist

Arithmos — Full Pythagorean/Chaldean readings. Life Path, Expression, Soul Urge, karmic patterns.

🗣️

Human Voice

South African English TTS & STT. Two distinct personas. Auto-speaks responses. Tap mic to talk.

Reference

All Commands

Speak or type naturally. ARA understands intent — these are examples, not exact syntax.
Tags show where the action runs: phone linux both

Setup

Desktop Bridge

ARA connects to your Arch Linux desktop over a local WebSocket. This enables shell commands, browser control, and file management.

1

Install dependency

pip install websockets
ℹ️ Only the websockets library is needed. No other dependencies.
2

Copy bridge script from app

In ARA → Settings → scroll to Linux Bridge → tap Copy aria_bridge.py to clipboard. Paste and save on your desktop.

The script is already embedded in the app. Settings → Linux Bridge → Copy.
3

Run the bridge

# Default — port 8765, secret "aria-secret"
python3 aria_bridge.py

# Custom port and secret
ARIA_SECRET="mysecret" ARIA_PORT="9000" python3 aria_bridge.py
💡 Run in a terminal that stays open. Use screen or tmux to keep it running after you close the terminal.
4

Connect in ARA

1. Open ARA → Settings
2. Set Bridge IP to your desktop's local IP
3. Set Port (default: 8765)
4. Set Secret to match ARIA_SECRET
5. Tap Connect

The green dot in the top bar confirms connection. You'll see "🟢 Connected" in Settings.

Environment Variables

VariableDefaultDescription
ARIA_SECRETaria-secretShared secret between app and bridge. Change this to something unique.
ARIA_PORT8765WebSocket port. Must match what you enter in ARA Settings.
DISPLAY:0X display for GUI commands (xdg-open, xdotool). Set to your display.
DBUS_SESSION_BUS_ADDRESSunix:path=/run/user/1000/busRequired for desktop notifications and some app launchers.

⚠️ Desktop commands not executing / "(done)" / timeout — Fix

Three separate issues were causing this. All are fixed in v4 — update both main.dart and your aria_bridge.py (copy from Settings → Linux Bridge → Copy again).

1
Root cause — xdg-open produces no stdout. GUI commands like xdg-open open a window and exit silently. The old bridge returned (no output) which displayed as (done). Fixed: ARA v4 now uses fire-and-forget wrapping (nohup cmd & echo launched:$!) which returns the process ID immediately instead of waiting for silent exit.
2
DISPLAY variable not set in bridge. The old bridge hardcoded DISPLAY=":0" which fails if your display is :1 or unset. Fixed: aria_bridge.py v2 auto-detects your display using xdpyinfo, checks /tmp/.X11-unix, and falls back gracefully. Run echo $DISPLAY in a terminal — v2 finds this automatically.
3
Timeout errors on long commands. The old 30s timeout was too short for some operations. Fixed: timeout extended to 45s in both bridge and app. Commands that genuinely time out now show a clear "Desktop command timed out" message instead of a generic error.
4
Say "on my desktop" or "on Linux" explicitly. Without this, ARA routes ambiguous commands to Android. Say: "open Firefox on my desktop", "search GitHub on Linux", "run ls on my desktop". The routing key words are: on my desktop · on Linux · on desktop.
5
Update aria_bridge.py. The new v2 script is embedded in the updated app. Go to Settings → Linux Bridge → Copy aria_bridge.py, paste and replace the old file on your desktop, restart it.
# Diagnostic commands — say these to ARA to test the bridge
"run echo $DISPLAY on my desktop" — returns :0 or :1 (confirms bridge alive)
"run ls on my desktop" — lists home dir files (confirms shell works)
"open Firefox on my desktop" — should open Firefox (tests xdg-open)
"search for GitHub on my desktop" — opens Brave search in browser
"close the Gmail tab on my desktop" — finds Firefox tab by title, sends Ctrl+W
"take a screenshot on my desktop" — saves ~/aria-timestamp.png
UI Reference

App Screens

Every tab in the app — what each one does and what it looks like.

CHAT
A
ARIA
gemini-2.0-flash
🖥
A
open WhatsApp on device
Opening WhatsApp.
🔧 ✓ WhatsApp opened
post about my SaaS on all socials
On it — confirm first.
🔧 ⚠️ Confirm needed
run security scan
Running now.
🔧 ✅ All clear
🎤
Message ARIA…
TOOLS
QUICK ACTIONS
💼
Find Jobs
📣
Post All Socials
📧
Check Emails
📅
Calendar
🛡️
Security Scan
📊
Daily Report
💬
WhatsApp
🖥
Linux Terminal
APP SCANNER
APP SCANNER
↺ Scan
● 17 compatible ○ 50 not detected
all
messaging
social
jobs
💬
WhatsApp
com.whatsapp
● Compatible
Open
🔵
LinkedIn
com.linkedin.android
● Compatible
Open
🎯
Indeed
com.indeed.android
● Compatible
Open
🛒
Amazon
com.amazon.mShop
Not installed
Try
SPIRITUAL · HEALER
🌿 TRADITIONAL HEALER
🔢 NUMEROLOGIST
U
UBULUMKO
Isangoma & Inyanga · Ngoma Tradition
🔊
Sawubona. I am Ubulumko — the knowing. Tell me what troubles your body, mind, or spirit.
I have recurring nightmares and feel disconnected
What you describe carries the marks of umnyama — spiritual heaviness. The dreams are the ancestors speaking through your sleep…
🎤
Ask Ubulumko…
SPIRITUAL · NUMEROLOGIST
🌿 TRADITIONAL HEALER
🔢 NUMEROLOGIST
Λ
ARITHMOS
Pythagorean · Chaldean · Kabbalic
🔊
NUMEROLOGY CALCULATOR
Full birth name
DD/MM/YYYY
LIFE PATH
7
EXPRESSION
11
SOUL URGE
3
PERS. YEAR
5
🎤
Ask Arithmos…
SETTINGS
SETTINGS
LLM BACKEND
Backend
Gemini 2.0 Flash
Gemini Key
••••••••AIzaSy
LINUX BRIDGE
Bridge IP
192.168.1.100
Port
8765
Status
🟢 Connected
VOICE
TTS Speed
0.45
Auto Send Voice
Spiritual Advisor

Healer & Numerologist

Two completely independent expert agents — separate conversations, separate voices, separate knowledge systems. Neither knows about the other. Neither knows about ARIA's tech tools.

UBULUMKO

ISANGOMA · INYANGA · NGOMA TRADITION

A bridge between the physical world and the ancestral realm. Diagnoses through the three lenses: ancestral displeasure, ritual pollution (umnyama), and witchcraft (ubuthakathi). Prescribes muthi using the tri-colour system — black (purge), red (transition), white (restoration).

Speaks slower and deeper, using South African English (en-ZA) voice. Begins every session with "Sawubona."

Ancestral diagnosis Mental health reading Ukuthwasa signs Cleansing & protection Grief & ancestors About Devil's Claw

ARITHMOS

PYTHAGOREAN · CHALDEAN · KABBALIC

Calculates all five core numbers in-device (no network needed): Life Path (grouping method), Expression, Soul Urge, Personality, Personal Year. Identifies karmic debt numbers (13/4, 14/5, 16/7, 19/1), shadow work by Life Path, and Expression vs Soul Urge conflicts that cause identity tension.

Built-in calculator panel. Gold cards for Master Numbers (11, 22, 33). AI generates fresh diagnostic questions from your profile.

Full reading Mental health Career alignment Karmic debt Personal Year Shadow work
Install

Download ARA

Free Android APK — no Play Store needed. Sideload directly to any Android device. Built on Flutter, targets Android 13+ (API 33) and Android 16.

ARA
v4.1 APK

The full app — chat, app scanner, job applications, social media, email, security scanning, traditional healer, numerologist, and Linux desktop bridge. All in one sideloadable APK.

Android 13+ / Android 16
~18MB APK
No Google Play required
Free — no subscription
Download APK aria.apk/download
Free forever
Gemini 2.0 Flash
🎙 Voice control
💻 Linux bridge
Spiritual advisor
05:45📶 🔋
A
ARIA
v4 · pollinations
Open WhatsApp
Opening.
🔧 ✓ WhatsApp opened
Run security scan
Running now.
🔧 ✅ All clear
🎤
Message ARA…
STEP 01

Allow unknown sources

On your Android device: Settings → Security → Install unknown apps → enable for your browser or file manager.

STEP 02

Download the APK

Tap the Download button above or visit aria.apk/download on your Android device's browser.

STEP 03

Install & open

Tap the downloaded APK in your notifications or file manager. Follow the install prompts. Open ARA.

STEP 04

Complete setup wizard

Grant mic + storage permissions. Add your free Gemini API key from aistudio.google.com for best results.

STEP 05 (optional)

Connect desktop bridge

Run aria_bridge.py on your Linux machine. Enter your desktop IP in Settings → Linux Bridge → Connect.