📋 پیش‌نیازها

⚡ پیش‌نیازها و نیازمندی‌ها

قبل از شروع، مطمئن شوید همه موارد زیر را دارید

📱
اندروید
اندروید ۷ به بالا
💻
Termux
از F-Droid نصب کنید
🌐
اینترنت
پایدار و با سرعت خوب
🧠
API Key
OpenAI / Claude
⏱️
زمان
~۲۰ دقیقه
💾
فضا
~۱GB خالی
🚀 شروع

🛠️ مراحل نصب

هر مرحله را دقیقاً به همین ترتیب اجرا کنید

۰۱

نصب و آماده‌سازی Termux

Setup Termux Environment

ابتدا Termux را از F-Droid نصب کنید.

🚫
هشدار: نسخه Google Play قدیمی است. حتماً از F-Droid دانلود کنید.
bash
# آپدیت مخازن
pkg update

# آپگرید پکیج‌ها
pkg upgrade -y

# نصب ابزارهای پایه
pkg install -y git python curl wget
🤖 مشکل دارید؟ این متن را به AI بدهید
من در مرحله نصب Termux مشکل دارم. وقتی pkg upgrade را اجرا می‌کنم خطا می‌گیرم. متن خطا: [اینجا بچسبانید]
۰۲

نصب Python و Virtual Environment

Python & venv

Hermes با Python کار می‌کند. محیط مجازی بسازید.

bash
# نصب Python
pkg install -y python

# ساخت پوشه پروژه
mkdir -p ~/hermes-agent && cd ~/hermes-agent

# ساخت venv
python -m venv venv

# فعال‌سازی
source venv/bin/activate

# آپگرید pip
pip install --upgrade pip
اگر (venv) در ابتدای خط دیدید، یعنی فعال شده!
۰۳

دانلود Hermes Agent

Clone Repository

سورس کد Hermes را از ریپوزیتوری رسمی دانلود کنید.

bash
# کلون کردن
cd ~/hermes-agent
git clone https://github.com/hermes-agent/hermes.git
cd hermes

# نصب dependencies
pip install -r requirements.txt
۰۴

تنظیم API Key و کانفیگ

Configuration

فایل کانفیگ را بسازید و تنظیمات را وارد کنید.

bash
# ایجاد کانفیگ
cp config.example.yaml config.yaml
micro config.yaml
yaml
llm:
  provider: openai
  api_key: sk-your-key
  model: gpt-4o-mini

termux:
  chat_platform: telegram
  telegram_bot_token: ""
  telegram_chat_id: ""
💡
برای Bot Telegram به @BotFather پیام دهید و /newbot بزنید.
۰۵

نصب وابستگی‌های سیستمی

System Dependencies

پکیج‌های سیستمی مورد نیاز را نصب کنید.

bash
pkg install -y build-essential libffi libxml2 libxslt openssl sqlite

pip install numpy scipy
۰۶

تست و اجرای اولیه

First Run

Hermes را اجرا و تست کنید!

bash
# اجرای اولیه
cd ~/hermes-agent/hermes
source venv/bin/activate
python -m hermes agent run

# یا:
hermes status
🎉
اگر Hermes is running دیدید، نصب موفق بود!
۰۷

راه‌اندازی Telegram Bot

Connect to Telegram

اتصال به تلگرام در ۳ مرحله:

  1. بات @BotFather را جستجو کنید
  2. پیام /newbot را بفرستید
  3. Token را در config.yaml بگذارید
bash
# تست اتصال
python -m hermes connect telegram

# اجرای پس‌زمینه با tmux
tmux new -s hermes
source venv/bin/activate
python -m hermes agent run
❓ سوالات

❓ سوالات متداول

🔹 آیا نصب Hermes رایگان است؟

بله، نصب رایگان است. اما برای مدل‌های هوش مصنوعی به API Key نیاز دارید که هزینه جداگانه دارد.

🔹 حداقل سیستم چیست؟

اندروید ۷ به بالا، ۲ گیگابایت فضای خالی، و ۳ گیگابایت RAM.

🔹 نسخه Google Play مناسب است؟

خیر، نسخه Google Play قدیمی است. حتماً از F-Droid نصب کنید.

🔹 چگونه به Telegram وصل کنم؟

از @BotFather توکن بگیرید و در config.yaml قرار دهید. سپس python -m hermes connect telegram را اجرا کنید.

🔹 بهترین LLM کدام است؟

برای شروع GPT-4o-mini اقتصادی است. برای کیفیت بهتر Claude Sonnet را امتحان کنید.