alex72-py/aria-termux

ARIA is an AI assistant designed specifically for Termux, which is an Android app that gives your phone a Linux-style terminal so you can run developer tools, write code, and run scripts. ARIA acts as a co-pilot inside that terminal, powered by Google's Gemma 4 AI models accessed through a free Google AI Studio API key. The problem it addresses is that Termux has a lot of unique quirks compared to a standard Linux desktop: it uses a different compiler (Clang instead of GCC), has Android-specific filesystem restrictions, and its package manager behaves differently. Generic AI assistants don't know about these specifics. ARIA includes an offline knowledge base covering common Termux errors, package management, Python virtual environments, Proot-Distro (a tool that lets you run full Linux distributions inside Termux), Android bridge tools, Git and SSH setup, and networking issues, all available without an internet connection. You interact with ARIA through slash commands in the terminal: /ask for general questions, /fix to analyze and repair a specific error message, /kb to search the offline knowledge base, /watch to enable automatic error detection that analyzes errors as they appear, and /models to list available Gemma models. A safety layer called Guardian assigns risk scores to commands ARIA might suggest and prompts you to confirm before anything potentially destructive runs. Installation requires cloning the repository in Termux, running pip to install Python dependencies, and then launching the app with python run_aria.py. On first run, a setup wizard asks for your Google AI Studio API key and preferences. The full README is longer than what was provided.