Natural Language Anime Media Server powered by Hermes Agent.
Talk to your anime server like it's a person — download episodes, track series, sync with Anilist, identify anime from screenshots, and manage your library. All through natural language, from Telegram, Discord, or CLI.
| Command | Result |
|---|---|
| "Download the latest Frieren" | Searches SubsPlease, grabs magnet, downloads via qbittorrent, organizes on disk |
| "Track One Piece weekly" | Creates a CRON job that auto-downloads new episodes |
| "Sync my Anilist" | Imports your watchlist, auto-tracks untracked series |
| "What anime is this?" + screenshot | Identifies anime using vision, offers to download |
| "Find this on multiple sources" | Parallel subagent search across SubsPlease & Nyaa |
| "What's in my library?" | Organized view of your collection with disk stats |
| "I dropped Series X" | Removes CRON, updates Anilist, optionally cleans files |
| "Recommend anime like Frieren" | Anilist-powered recommendations |
This isn't a script with a chatbot wrapper. Each feature uses Hermes Agent capabilities that can't be replicated with simple automation:
| Feature | Hermes Capability |
|---|---|
| Natural language commands | LLM understanding + tool orchestration |
| Multi-source download | delegate_task — parallel subagent searches |
| Anime identification | vision_analyze — image understanding |
| Auto-tracking | schedule_cronjob — NL-defined CRON jobs |
| Cross-platform | send_message — Telegram, Discord, CLI |
| Taste learning | memory — persistent preferences |
| Self-improving | Skills system — workflows improve over time |
# 1. Install Hermes Agent (if you haven't)
# See: https://github.com/NousResearch/hermes-agent
# 2. Clone and install AniHermes
git clone https://github.com/YOUR_USERNAME/anihermes.git
cd anihermes
./install.sh
# 3. Start using it
hermes "What anime is airing this season?"
hermes "Download the latest episode of Frieren"- Hermes Agent
- Python 3.8+ (stdlib only, no pip packages needed)
- qbittorrent with WebUI enabled
- Storage for anime (any directory)
- Telegram bot (for mobile access) — setup guide
- Anilist account (for watchlist sync) — setup guide
install.sh creates ~/.hermes/anihermes/config.yaml:
storage:
anime_path: ~/Anime
torrent:
client: qbittorrent
webui_url: http://localhost:8081
sources:
preferred: subsplease
fallbacks: [nyaa]
quality: 1080p
anilist:
username: "your_username"Secrets (qbittorrent password, Anilist OAuth token) are stored in ~/.hermes/.env, never in config files.
See docs/SETUP.md for full configuration reference.
User (Telegram/CLI/Discord)
|
v
Hermes Agent (NL understanding + tool orchestration)
|
|-- web_search / web_extract --> SubsPlease, Nyaa
|-- delegate_task -------------> Parallel source searches
|-- vision_analyze ------------> Anime scene identification
|-- terminal ------------------> scripts/*.py (config-driven)
|-- schedule_cronjob ----------> Weekly episode checks
|-- memory --------------------> User preferences
|-- send_message --------------> Notifications
|
v
qbittorrent --> Your anime library
Anilist API --> Watch progress tracking
All scripts are standalone and can be used independently:
# Search SubsPlease
python3 ~/.hermes/scripts/anihermes_subsplease.py search "Frieren"
python3 ~/.hermes/scripts/anihermes_subsplease.py latest "Frieren"
python3 ~/.hermes/scripts/anihermes_subsplease.py schedule
# Search Anilist
python3 ~/.hermes/scripts/anihermes_anilist_api.py search "Frieren"
python3 ~/.hermes/scripts/anihermes_anilist_api.py watchlist your_username
python3 ~/.hermes/scripts/anihermes_anilist_api.py recommendations 154587
# Manage library
python3 ~/.hermes/scripts/anihermes_library_manager.py list
python3 ~/.hermes/scripts/anihermes_library_manager.py stats
python3 ~/.hermes/scripts/anihermes_library_manager.py info "Frieren"
# Download torrent
python3 ~/.hermes/scripts/anihermes_add_torrent.py --series "Frieren" --season "S2" --magnet "magnet:..."- Setup Guide — Detailed installation and configuration
- Telegram Setup — Telegram bot integration
- Anilist Setup — Anilist OAuth and watchlist sync
AniHermes is provided "as is", without warranty of any kind. This software is a media management and automation framework intended for use with legally obtained content. The developers do not host, distribute, or provide access to any copyrighted material.
Users are solely responsible for ensuring that their use of this software complies with all applicable local, state, national, and international laws, including copyright and intellectual property laws. The developers assume no liability for any misuse of this software or for any content downloaded, managed, or distributed by users through this tool.
By using this software, you agree that the developers shall not be held responsible or liable for any damages, legal actions, or claims arising from your use of the software or the content you obtain through it.
This project references third-party services and APIs (SubsPlease, Nyaa.si, Anilist, MyAnimeList). These services are independently operated, and the developers of AniHermes have no affiliation with, endorsement from, or responsibility for those services or their content.
MIT