1 line
6.5 KiB
JSON
1 line
6.5 KiB
JSON
{"repo": "amirghm/hermes-agent-mobile", "files": {"README.md": {"4a9cf07702bab44a191d7bd6ee3bd387edef467a": {"t": 1785595231.8912196, "n": 6184, "h": "1b2289efbf783466", "c": "<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/NousResearch/hermes-agent/main/assets/banner.png\" alt=\"Hermes Agent\" width=\"100%\">\n</p>\n\n# Hermes-Agent Mobile ☤\n\n<p align=\"center\">\n <a href=\"https://github.com/amirghm/hermes-agent-mobile/releases\"><img src=\"https://img.shields.io/github/v/release/amirghm/hermes-agent-mobile?style=for-the-badge&color=blue\" alt=\"Release\"></a>\n <a href=\"https://github.com/amirghm/hermes-kanban\"><img src=\"https://img.shields.io/badge/Kanban-Board-FF6B35?style=for-the-badge&logo=github\" alt=\"Kanban Board\"></a>\n <a href=\"https://hermes-agent.nousresearch.com\"><img src=\"https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge\" alt=\"Docs\"></a>\n <a href=\"https://github.com/amirghm/hermes-agent-mobile/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/License-MIT-green?style=for-the-badge\" alt=\"License: MIT\"></a>\n</p>\n\n<p align=\"center\">\n <img src=\"images/installation.jpg\" alt=\"Installation\" width=\"30%\">\n <img src=\"images/termux-hermes-running.jpg\" alt=\"Hermes Running\" width=\"30%\">\n <img src=\"images/telegram-bot.jpg\" alt=\"Telegram Bot\" width=\"30%\">\n</p>\n\n🤖 **Your AI assistant, right in your pocket.**\n\nHermes-Agent is a fully featured AI agent framework. This project brings it to Android (Termux) and iOS (iSH), so you get a personal AI that's always with you. No cloud servers, no laptop needed. Just your phone and an API key.\n\n## Why Run Hermes on Your Phone?\n\n**🏠 Always Available**\nYour assistant lives in your pocket. No booting a laptop, no SSH into servers. It's just there, ready to go.\n\n**👥 Team of Agents**\nRun multiple AI personas at the same time, each with their own personality and role. Like having a full team in your pocket.\n\n**💬 Talk Through Telegram**\nSend voice messages, images, files to your agents through Telegram. They respond like real team members. You can even create a group with all of them.\n\n**💰 Super Low Cost**\nRuns on cheap API models like Mimo v2.5 via OpenRouter. No expensive GPU server needed.\n\n**🔋 Runs in Background, Saves Battery**\nHermes keeps running even when your screen is off. With a few settings, your agents work 24/7 without draining your battery. [Guide: Keep Hermes alive in the background](docs/phantom-killer-guide.md)\n\n**✈️ Take It Anywhere**\nInstall on any phone in under 5 minutes. Your entire AI setup is portable.\n\n**🔒 Your Data Stays Private**\nNo third-party servers storing your conversations. API calls go straight from your phone to the model provider.\n\n## Use Cases\n\n**Personal assistant on the go**\nAsk questions, get translations, summarize articles, manage your schedule. All from your phone, even with the screen off.\n\n**Team of AI agents**\nCreate a Telegram group with 7 agents, each with a role. Kaveh manages the team, Shirin handles marketing, Dariush writes code, Yasaman analyzes data. Mention any of them and they respond.\n\n**Voice-powered workflow**\nSend a voice message in Persian, English, or German. Hermes transcribes it, understands it, and responds. You can even have it read back the response.\n\n**Automated monitoring**\nSet up cron jobs to monitor websites, check prices, send alerts. Your phone becomes a 24/7 monitoring station.\n\n**Content creation**\nGenerate blog posts, social media content, scripts. Have agents collaborate on bigger pieces of work.\n\n## What Works on Termux\n\n| Feature | Status | Notes |\n|---------|--------|-------|\n| Chat / CLI mode | ✅ | Core functionality |\n| Telegram Gateway | ✅ | Full bot integration with groups |\n| Voice input (STT) | ✅ | Speechmatics with auto language detection |\n| Voice output (TTS) | ✅ | Edge TTS with Persian voice |\n| Memory | ✅ | Persistent across sessions |\n| Skills | ✅ | Load, create, manage skills |\n| Cron jobs | ✅ | Scheduled tasks and monitoring |\n| File operations | ✅ | Read, write, edit files |\n| Web search | ✅ | Brave search API |\n| Browser | ✅ | Firefox headless via Playwright |\n| Chromium | ⚠️ | PRoot sandbox issues. Always use Firefox |\n| Image generation | ✅ | Via API (FAL, OpenAI, etc.) |\n| Multiple agents | ✅ | Run 7+ bots at the same time |\n| Subagent delegation | ✅ | Parallel task execution |\n| Background running | ✅ | With Phantom Killer disabled |\n\n## What Works on iSH (iOS)\n\n| Feature | Status | Notes |\n|---------|--------|-------|\n| Chat / CLI mode | ✅ | Via hermes-agent --prompt |\n| Telegram Gateway | ❌ | iSH lacks subprocess syscalls |\n| Voice input (STT) | ❌ | Requires gateway mode |\n| Voice output (TTS) | ❌ | Requires gateway mode |\n| Memory | ✅ | Persistent across sessions |\n| Skills | ✅ | Available in CLI mode |\n| Cron jobs | ❌ | Requires gateway mode |\n| File operations | ✅ | Read, write, edit files |\n| Web search | ✅ | Via API calls |\n\n## Quick Install\n\n### 📱 Android (Termux)\n\nOne command does everything: installs Debian, Firefox, Hermes, and then asks how you want to configure it.\n\n```sh\nbash <(curl -fsSL https://raw.githubusercontent.com/amirghm/hermes-agent-mobile/main/scripts/install-termux.sh)\n```\n\nDuring setup you can choose:\n\n- **Quick setup** - enter only your OpenRouter API key and Telegram bot token. The installer uses `xiaomi/mimo-v2.5`, configures Telegram, starts the gateway, and opens Hermes.\n- **Normal setup** - run the official Hermes setup wizard for custom providers, models, gateways, and advanced options.\n\n**Recommended model:** `xiaomi/mimo-v2.5` (free via OpenRouter)\n\n- `hermes` - Start Hermes chat\n- `hermes setup` - Configure API key & model\n- `hermes gateway` - Start Telegram/messaging gateway\n- `debian` - Enter Debian shell\n\n### 🍎 iOS (iSH)\n\n```sh\ncurl -fsSL https://raw.githubusercontent.com/amirghm/hermes-agent-mobile/main/scripts/install-ish.sh -o /tmp/install.sh && sh /tmp/install.sh\n```\n\nFor iSH, configure manually after install:\n\n```sh\nnano ~/.hermes/.env\n```\n\nAdd your OpenRouter API key (get one free at https://openrouter.ai):\n\n```\nOPENROUTER_API_KEY=sk-or-...\n```\n\n## Requirements\n\n| Platform | What you need |\n|----------|--------------|\n| Android | Termux app (Google Play works for this setup; F-Droid/GitHub recommended for advanced Termux usage), ~4GB free storage |\n| iOS | iSH app (App Store), ~200MB storage |\n\n## License\n\nMIT\n"}}}} |