AbuZar-Ansarii/Hermes-Agent-On-Android
Run Hermes Agent - a self-evolving AI assistant - on any Android device using Termux. One-line installation.
This project provides a Termux-based installer and configuration guide for deploying the Nous Research Hermes Agent on Android devices. It automates the setup of a Linux environment via proot-distro to run the Python-based agent framework and its persistent memory systems locally. The installer enables mobile access to over 70 built-in tools and supports integration with both cloud-based APIs and local models via Ollama.
- One-line automated installation script for Termux environments
- Supports local model execution using Ollama on Android
- Enables persistent memory and cross-platform tool execution
full readme from github
☤ Hermes Agent for Android (Termux)
Run a Self-Evolving AI Assistant on Your Phone
Transform your Android device into a powerful, learning AI assistant
✨ What is Hermes Agent?
Hermes Agent is an open-source, self-evolving AI framework developed by Nous Research. It's like having Jarvis in your pocket - an AI that learns, adapts, and grows smarter with every interaction.
| 🧠 Self-Learning | 🔄 Cross-Platform | 💾 Persistent Memory | 🛠️ 70+ Tools |
|---|---|---|---|
| Gets smarter over time | Works on 16+ apps | Remembers your preferences | Execute complex tasks |
⏱️ Installation takes ~5-10 minutes - Grab a coffee! ☕
Installation Preview:
graph LR
A[📱 Open Termux] --> B[📋 Copy Command]
B --> C[⚡ Paste & Run]
C --> D[🔄 Auto-Install]
D --> E[✅ Ready to Use!]
🚀 One-Line Installation
Copy and paste this command in Termux:
curl -fsSL https://raw.githubusercontent.com/AbuZar-Ansarii/Hermes-Agent-On-Android/main/nous_agent.sh | bash
🛠️ Manual Installation (Recommended)
Prefer to do it yourself? Here's the step-by-step:
pkg install git
# 1. Clone this repository
git clone https://github.com/AbuZar-Ansarii/Hermes-Agent-On-Android.git
cd Hermes-Agent-On-Android
# 2. Make the script executable
chmod +x agent_install.sh
# 3. Run the installer
./agent_install.sh
🤖 Start Agent
Run these commands one by one after installling
cd
proot-distro login ubuntu
cd hermes-agent
source venv/bin/activate
Run for setting it up
hermes setup
Run for using it
hermes
Start gateway
hermes gateway
⚙️ System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| Android Version | 11 | 13,14 or 15 |
| Storage Space | 3GB | 5GB+ |
| RAM | 2GB | 4GB+ |
| Internet | Required | Fast connection |
| Termux | Latest | Latest from F-Droid |
🌍 Why Run Hermes on Android?
| Benefit | Description |
|---|---|
| 📱 Portable AI | Your assistant goes everywhere |
| 🔒 Privacy | Runs locally on your device |
| 💰 Cost-effective | No server hosting fees |
| ⚡ Low latency | Direct execution |
| 🔄 Always available | Works offline (with local models) |
🎛️ AI Model Freedom
Compatible with 200+ AI models including:
• OpenAI (GPT-4, GPT-3.5)
• Anthropic (Claude)
• Google (Gemini)
• DeepSeek
• Alibaba (Qwen)
• Zhipu (GLM)
• Local models via Ollama
🦙 Running Local Models with Ollama
📋 Installation
Install Ollama on Termux:
pkg install ollama
ollama serve
Pull & Run Models
ollama run gemma4:31b-cloud
🙏 Acknowledgments
• Nous Research - For creating the amazing Hermes Agent
• Termux Team - For making Android development possible
• Open Source Community - For the countless tools and libraries
• You - For using and supporting this project! ❤️