Emblem AI: automation for Hermes Agent

Personal Hermes-based agent with Emblem Vault crypto wallets, portfolio tracking and scheduled jobs

What Emblem AI does

Emblem AI is a Python project written as a personal agent for a single owner and built on Nous Research's Hermes agent framework. Its crypto skills use Emblem Vault, which the README credits with 200+ trading tools across seven chains: Solana, Ethereum, Base, BSC, Polygon, Hedera and Bitcoin. The agent can swap, bridge and manage tokens, take portfolio snapshots, track profit and loss, and raise allocation drift alerts.

Memory is stored in SQLite with FTS5 full-text search. A scheduler runs unattended jobs: a portfolio check every four hours, a morning briefing at 8 AM, news digests at noon and 6 PM, an alert check every 15 minutes and a memory nudge every 30 minutes. A defined persona is cautious with money, confirms large trades and never shares keys. CLI, Telegram and Discord adapters let a conversation start on one surface and continue on another.

Key features

Swap, bridge and manage tokens across seven blockchains through Emblem Vault
Portfolio snapshots, profit and loss tracking and allocation drift alerts
SQLite memory with FTS5 full-text search
Scheduled morning briefings, news digests and alert checks
CLI, Telegram and Discord adapters
Token lookup, market overview and safety checks

When to use it

Getting a daily crypto portfolio briefing in a chat app
Moving tokens between chains through Emblem Vault, with confirmation for large trades
Researching tokens and collecting crypto news on a schedule

Who it is for: Crypto holders comfortable with Python who want a Hermes-based personal agent for portfolio monitoring and trading tasks.

How it fits with Hermes Agent

It is built on Nous Research's Hermes agent framework, tagged hermes-agent, and runs from its own emblem_ai.py entry point.

How to install Emblem AI

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/Adam-McBride/Emblem-AI.git
cd Emblem-AI
pip install -e .
cp .env.example .env

Requirements: An LLM API key (OpenRouter, OpenAI or Anthropic), an Emblem Vault API key and wallet password; optional Telegram and Discord bot tokens

Note: It is a personal agent that signs crypto transactions with a wallet password, the README says it gives no financial advice, and GitHub does not detect a license file although the README says MIT.

FAQ

What is Emblem AI?

Emblem AI is a personal crypto agent built on the Hermes agent framework with Emblem Vault integration. It handles token swaps and bridging, portfolio tracking, scheduled briefings and persistent memory.

How do I install Emblem AI?

Clone the repository, run pip install -e ., copy .env.example to .env and fill in your API keys, then start it with python emblem_ai.py. The clone URL in the README is https://github.com/Adam-McBride/Emblem-AI.git.

What do I need to run Emblem AI?

You need an LLM key (OPENROUTER_API_KEY, which can be an OpenRouter, OpenAI or Anthropic key), an EMBLEM_API_KEY and an EMBLEM_WALLET_PASSWORD for signing transactions. TELEGRAM_BOT_TOKEN and DISCORD_BOT_TOKEN are optional, for the chat gateways.