{"id":49773189,"url":"https://github.com/alex72-py/aria-termux","last_synced_at":"2026-05-11T14:05:07.979Z","repository":{"id":357087408,"uuid":"1235293069","full_name":"Alex72-py/aria-termux","owner":"Alex72-py","description":"Terminal-native AI assistant built specifically for Termux and Android development.","archived":false,"fork":false,"pushed_at":"2026-05-11T08:21:26.000Z","size":74,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-11T10:14:51.098Z","etag":null,"topics":["ai","ai-agents","aiagent","android","assistant","cli","gemma","gemma4","llm","mobile","mobile-development","mobile-first","mobile-friendly","python","termux"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Alex72-py.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T07:28:10.000Z","updated_at":"2026-05-11T08:29:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Alex72-py/aria-termux","commit_stats":null,"previous_names":["alex72-py/aria-termux"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Alex72-py/aria-termux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alex72-py%2Faria-termux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alex72-py%2Faria-termux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alex72-py%2Faria-termux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alex72-py%2Faria-termux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alex72-py","download_url":"https://codeload.github.com/Alex72-py/aria-termux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alex72-py%2Faria-termux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32897962,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","aiagent","android","assistant","cli","gemma","gemma4","llm","mobile","mobile-development","mobile-first","mobile-friendly","python","termux"],"created_at":"2026-05-11T14:05:06.952Z","updated_at":"2026-05-11T14:05:07.965Z","avatar_url":"https://github.com/Alex72-py.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🚀 ARIA — AI Terminal Co-Pilot for Termux\n\n[![Python](https://img.shields.io/badge/Python-89%25-3776ab?logo=python\u0026logoColor=white)](https://python.org)\n[![Shell](https://img.shields.io/badge/Shell-11%25-4EAA25?logo=gnu-bash\u0026logoColor=white)](https://www.gnu.org/software/bash/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Google Gemma 4](https://img.shields.io/badge/Google%20Gemma-4-4285F4?logo=google\u0026logoColor=white)](https://ai.google.dev/)\n\n\u003e **Built for developers who use Termux as a real development environment on Android.**\n\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents\n\n- [About](#about)\n- [✨ Features](#-features)\n- [📸 Screenshots](#-screenshots)\n- [🎬 Demo](#-demo)\n- [🚀 Quick Start](#-quick-start)\n- [🔑 First Run](#-first-run)\n- [📖 Usage](#-usage)\n- [🏗️ Architecture](#-architecture)\n- [🧠 Knowledge Base](#-knowledge-base)\n- [🛡️ Safety Features](#-safety-features)\n- [📊 Supported Models](#-supported-models)\n- [⚙️ Configuration](#-configuration)\n- [🧪 Testing](#-testing)\n- [⚠️ Limitations](#-limitations)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n\n---\n\n## About\n\nARIA is a terminal-native AI assistant designed specifically for Termux and Android development workflows. It combines Google's Gemma 4 models with a Termux-focused knowledge base, command system, and[...]\n\n### Why ARIA?\n\nUnlike generic desktop-focused coding assistants, ARIA understands the unique constraints of Android-based development:\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n⚙️ **Clang** instead of GCC  \n🗂️ **Android filesystem quirks**  \n🔒 **Proot/container environments**  \n\n\u003c/td\u003e\n\u003ctd\u003e\n\n📱 **Mobile-only workflows**  \n🚫 **Package and permission limitations**  \n🐛 **Termux-specific debugging patterns**  \n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## ✨ Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n### 💻 Advanced Terminal UI\n- Slash Command Interface (`/ask`, `/fix`, `/models`, `/watch`)\n- Rich syntax highlighting \u0026 formatting\n- Animated startup sequences\n- Color-coded output\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n### 🤖 Intelligent AI\n- Dynamic Gemma model discovery\n- Auto model switching\n- Self-healing API layer\n- Graceful fallback handling\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n### 🛡️ Safety First\n- Risk scoring system\n- Confirmation prompts for dangerous operations\n- Guardian safety layer\n- Multi-level command validation\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n### 📚 Knowledge Base\n- Common Termux errors\n- Package management tips\n- Python environments\n- Proot-distro setup\n- Android bridge tools\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd colspan=\"2\"\u003e\n\n### 📋 Additional Features\n- **Clipboard Integration**: Copy commands with one keystroke  \n- **Watch Mode**: Auto-detect and analyze terminal errors  \n- **Offline Support**: Works without internet for KB queries  \n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 📸 Screenshots\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e📱 Click to expand screenshot gallery\u003c/b\u003e\u003c/summary\u003e\n\n### Startup Interface\n\u003cimg width=\"1080\" height=\"1739\" alt=\"Startup Screen\" src=\"https://github.com/user-attachments/assets/72ccd238-74a9-4dd0-8e2c-97c00ec17584\" /\u003e\n\n### Model Selection\n\u003cimg width=\"1080\" height=\"2157\" alt=\"Model Selection\" src=\"https://github.com/user-attachments/assets/8f8a4674-ba89-4204-8f99-f54bbca52833\" /\u003e\n\n### Error Analysis\n\u003cimg width=\"1079\" height=\"2162\" alt=\"Error Analysis\" src=\"https://github.com/user-attachments/assets/a216a5a2-9897-4e68-90ed-94dfe55bae00\" /\u003e\n\n\u003c/details\u003e\n\n---\n\n## 🎬 Demo\n\n\n\nhttps://github.com/user-attachments/assets/0bdec9c0-fd24-4844-8c09-aea0cd376e34\n\n\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Termux app on Android\n- Python 3.8+\n- Internet connection (for AI features)\n\n### Installation\n\n```bash\n# Update system packages\npkg update \u0026\u0026 pkg upgrade -y\n\n# Install required tools\npkg install python git -y\npkg install termux-api -y\n\n# Clone and install ARIA\ngit clone https://github.com/Alex72-py/aria-termux.git\ncd aria-termux\n\n# Install Python dependencies\npip install -r requirements.txt\n\n# Launch ARIA\npython run_aria.py\n```\n\n\u003e 💡 **Tip:** `termux-api` is optional but recommended for clipboard integration. ARIA will gracefully fall back without it.\n\n---\n\n## 🔑 First Run\n\nARIA launches an interactive configuration wizard on first startup:\n\n```\n╔══════════════════════════════════════════╗\n║  Welcome to ARIA Configuration Wizard    ║\n╚══════════════════════════════════════════╝\n\nEnter Google AI Studio API key: ••••••••••••••\nEnter preferred model: gemma-4-31b-it\nEnable Guardian mode? [y/n]: y\nEnable watch mode? [y/n]: n\n```\n\n**Get your free API key here:**  \n🔗 [Google AI Studio](https://aistudio.google.com/app/apikey)\n\n---\n\n## 📖 Usage\n\n### Command Reference\n\n\u003ctable\u003e\n\u003ctr\u003e\u003cth\u003eCommand\u003c/th\u003e\u003cth\u003eDescription\u003c/th\u003e\u003cth\u003eExample\u003c/th\u003e\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003ccode\u003e/ask\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eAsk ARIA any question about Termux or development\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e/ask How do I install Python on Termux?\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003ccode\u003e/fix\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eAnalyze and fix terminal errors\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e/fix \"clang: error: linker command failed\"\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003ccode\u003e/models\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eList all available Gemma models\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e/models\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003ccode\u003e/kb\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eSearch the offline knowledge base\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e/kb python module not found\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003ccode\u003e/watch\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eEnable automatic error detection\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e/watch\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────┐\n│           ARIA Core System              │\n├─────────────────────────────────────────┤\n│  📋 Command System                      │\n│  ├─ /ask, /fix, /models, /kb, /watch   │\n│                                         │\n│  🤖 API Client                          │\n│  ├─ Auto Model Discovery                │\n│  ├─ Intelligent Retry Logic             │\n│  └─ Fallback Handling                   │\n│                                         │\n│  🛡️ Guardian Safety Layer               │\n│  ├─ Risk Assessment                     │\n│  └─ Confirmation Prompts                │\n│                                         │\n│  👀 Watch Mode                          │\n│  ├─ Error Detection                     │\n│  └─ Auto Analysis                       │\n│                                         │\n│  📚 Offline Knowledge Base              │\n│  └─ Termux Troubleshooting              │\n│                                         │\n│  🎨 Rich Terminal UI                    │\n│  ├─ Syntax Highlighting                 │\n│  ├─ Animations                          │\n│  └─ Color-Coded Output                  │\n└─────────────────────────────────────────┘\n```\n\n---\n\n## 🧠 Knowledge Base\n\nARIA includes comprehensive offline knowledge covering:\n\n| Category | Topics |\n|----------|--------|\n| 🐛 **Common Errors** | Package conflicts, permission issues, build errors |\n| 📦 **Package Management** | pkg, apt, pip installation \u0026 troubleshooting |\n| 🐍 **Python** | Virtual environments, venv, pip caching |\n| 🐧 **Proot-Distro** | Linux distributions, container setup |\n| 🔌 **Android Bridge** | Termux:API, Tasker integration, system access |\n| 🔐 **Git \u0026 SSH** | SSH keys, Git configuration, GitHub access |\n| 🌐 **Networking** | Port forwarding, localhost, DNS issues |\n\n---\n\n## 🛡️ Safety Features\n\n### Guardian Safety Layer\n\nARIA analyzes potentially dangerous commands before execution with a comprehensive risk assessment system:\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003cth\u003eRisk Level\u003c/th\u003e\n\u003cth\u003eColor\u003c/th\u003e\n\u003cth\u003eDescription\u003c/th\u003e\n\u003cth\u003eAction\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e🟢 Low\u003c/td\u003e\n\u003ctd\u003eGreen\u003c/td\u003e\n\u003ctd\u003eSafe operations (listing, viewing)\u003c/td\u003e\n\u003ctd\u003eExecute immediately\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e🟡 Medium\u003c/td\u003e\n\u003ctd\u003eYellow\u003c/td\u003e\n\u003ctd\u003eNetwork/code operations\u003c/td\u003e\n\u003ctd\u003eExecute with notice\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e🟠 High\u003c/td\u003e\n\u003ctd\u003eOrange\u003c/td\u003e\n\u003ctd\u003eUser/system modifications\u003c/td\u003e\n\u003ctd\u003eRequire confirmation\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e🔴 Critical\u003c/td\u003e\n\u003ctd\u003eRed\u003c/td\u003e\n\u003ctd\u003eRecursive deletion, destructive commands\u003c/td\u003e\n\u003ctd\u003eRequire explicit approval\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 📊 Supported Models\n\nARIA supports the full lineup of Google Gemma 4 models:\n\n```\nGemma 4 Model Family\n├── gemma-4-2b-it      (Lightweight, 2B parameters)\n├── gemma-4-4b-it      (Balanced, 4B parameters)\n├── gemma-4-26b-a4b-it (Advanced, 26B parameters)\n└── gemma-4-31b-it     (Expert, 31B parameters)\n```\n\n**Auto-discovery:** ARIA fetches available models from your API key automatically.\n\n---\n\n## ⚙️ Configuration\n\n### Config File\n\nConfiguration is stored locally in:\n```\n~/.aria/config.json\n```\n\nExample structure:\n```json\n{\n  \"api_key\": \"your-google-ai-studio-key\",\n  \"model\": \"gemma-4-31b-it\",\n  \"guardian_mode\": true,\n  \"watch_mode\": false\n}\n```\n\n### Environment Variables\n\nOverride config with environment variables:\n\n```bash\nexport ARIA_API_KEY=\"your-key\"\nexport ARIA_MODEL=\"gemma-4-31b-it\"\nexport ARIA_GUARDIAN_MODE=\"true\"\n```\n\n---\n\n## 🧪 Testing\n\nRun the test suite with pytest:\n\n```bash\n# Run all tests\npython -m pytest tests/\n\n# Run with verbose output\npython -m pytest tests/ -v\n\n# Run specific test file\npython -m pytest tests/test_api.py\n```\n\n---\n\n## ⚠️ Limitations\n\n\u003e **Development Status:** This is a hackathon submission. These limitations are planned for future releases.\n\n- 🔄 Watch mode is experimental and may require manual review\n- 🌐 Internet connection required for AI features (knowledge base works offline)\n- 📱 Optimized primarily for Termux on Android\n- 🤔 Some auto-fix suggestions require manual verification\n- 📊 Transparent reasoning output shows intermediate model thinking\n\n---\n\n## 🧠 Transparent Reasoning\n\nARIA intentionally exposes intermediate reasoning during operations. This helps:\n\n✅ Debug prompt and model behavior  \n✅ Inspect reasoning quality  \n✅ Improve transparency during testing  \n✅ Analyze response generation in real time  \n\n**Future releases** will include:\n- Optional hidden reasoning mode\n- Cleaner response streaming\n- User-configurable verbosity levels\n- Dedicated developer/debug modes\n\n---\n\n## 📦 Dependencies\n\n| Package | Purpose |\n|---------|---------|\n| `google-generativeai` | Google Gemma API client |\n| `rich` | Rich terminal formatting \u0026 UI |\n| `click` | CLI command interface |\n| `pydantic` | Data validation \u0026 models |\n| `python-dotenv` | Environment variable management |\n\nSee `requirements.txt` for versions and additional dependencies.\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how to get started:\n\n```bash\n# Create a feature branch\ngit checkout -b feature/my-feature\n\n# Make your changes and commit\ngit add .\ngit commit -m \"Add my feature\"\n\n# Push and create a pull request\ngit push origin feature/my-feature\n```\n\n**Guidelines:**\n- Follow PEP 8 for Python code\n- Add tests for new features\n- Update documentation\n- Keep commits focused and descriptive\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n```\nMIT License\n\nCopyright (c) 2026 Alex72-py\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n```\n\n---\n\n## 🎯 Hackathon Submission\n\n**Submitted for:** Google Gemma 4 Challenge\n\n### 🏆 Highlights\n\n- 🎯 **Real-world Focus**: Actual Termux developer workflow optimization\n- 🔄 **Dynamic Discovery**: Auto-detect and switch between available models\n- 🛡️ **Resilient API**: Self-healing with intelligent retry logic\n- 📱 **Mobile-First**: Terminal UI optimized for small screens\n- 💾 **Offline Ready**: Fallback support without internet connection\n- 🔐 **Safety-Conscious**: Risk assessment before executing commands\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### 🚀 ARIA\n\n*Making Android terminal development faster, safer, and more usable.*\n\n**[⬆ back to top](#-aria--ai-terminal-co-pilot-for-termux)**\n\n[![Stars](https://img.shields.io/github/stars/Alex72-py/aria-termux?style=social)](https://github.com/Alex72-py/aria-termux)\n[![GitHub](https://img.shields.io/badge/GitHub-Alex72--py-181717?logo=github)](https://github.com/Alex72-py)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex72-py%2Faria-termux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falex72-py%2Faria-termux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex72-py%2Faria-termux/lists"}