A complete step-by-step guide to installing Hermes Agent on any platform — Linux, macOS, Windows, Android — connecting it to Telegram, choosing your AI...

Hong Kong is not a city for the slow-every minute wasted on repetitive manual work is a minute your competitor in Shenzhen or Singapore uses to gain an edge. I have spent the last decade building tech in this city, and the most significant shift I have witnessed is the transition from "assistants" to "agents." While everyone else is still debating prompts in a browser window, the high-performers I know are building local-first, autonomous workflows. This is why I am writing this guide on Hermes Agent. It is not just another wrapper for an LLM; it is a framework that allows you to orchestrate a fleet of autonomous specialists capable of handling everything from deep technical documentation to complex cross-border market research.
When I first sat down at my desk to set up Hermes, I realized most guides were either too shallow for a technical founder or too dense for someone who actually has a business to run. I did not want a toy; I wanted a digital workforce that could live in my terminal and integrate with my existing tech stack. This guide is the result of that frustration-a comprehensive, field-tested walkthrough for setting up Hermes Agent from the ground up, optimized for speed, privacy, and real-world utility in a professional environment.
The year 2025 has seen a massive surge in agentic AI adoption. According to recent McKinsey data, 23% of organizations are already scaling agentic AI systems, while an additional 39% have begun pilot programs. In the enterprise world, the projection is even more aggressive-Gartner estimates that by 2028, 33% of enterprise software applications will include agentic AI, up from less than 1% just a year ago.
For a founder, the distinction between a chatbot and an agent is fundamental. A chatbot waits for you. An agent works for you. Hermes 3, developed by the team at Nous Research, is specifically designed for this latter role. It is a neutrally-aligned generalist instruct and tool-use model that excels in reasoning. In my own testing, the Hermes 3 70B model has shown a remarkable ability to handle complex, multi-step plans without losing the objective-a feat that many other open-weight models struggle with.
In a Hong Kong context, where data privacy and cross-border connectivity are paramount, having an agent that can run on your own hardware or a private VPS is a game changer. You are not just renting intelligence; you are building an asset that belongs to your firm.
Before we get into the terminal, you need to understand how Hermes thinks and acts. The framework is built on three pillars-the Brain, the Skills, and the Plugins.
As founders operating in the Greater Bay Area, we deal with a unique set of regulatory and privacy challenges. Using a localized agent like Hermes ensures that your proprietary business logic, client data, and internal strategies never leave your controlled environment. Whether you are running it on a Mac Studio in your office or a private instance in a local data center, you maintain 100% data sovereignty.
To run a production-grade Hermes Agent, you need more than just a laptop. I recommend a dedicated environment.
Unless you are running a massive H100 cluster locally, you will likely want to start with an API provider for the inference. 1. OpenRouter: My primary choice for development. It provides access to the full Nous Research suite (8B to 405B) with one unified key. 2. Groq: If you need raw speed. Groq’s LPU architecture can push hundreds of tokens per second, which is vital for agents that need to perform complex internal reasoning loops before responding. 3. Lambda Labs: Excellent for dedicated GPU instances if you decide to self-host the model.
Do not install Hermes into your system Python. You will regret it when a dependency conflict breaks your system tools. We will use a virtual environment to keep everything isolated and clean.
Hit:1 https://download.docker.com/linux/ubuntu resolute InRelease Hit:2 http://archive.ubuntu.com/ubuntu resolute InRelease Hit:3 http://archive.ubuntu.com/ubuntu resolute-updates InRelease Hit:4 http://security.ubuntu.com/ubuntu resolute-security InRelease Hit:5 http://archive.ubuntu.com/ubuntu resolute-backports InRelease Reading package lists...
The Hermes CLI is the primary way we interact with the agent engine. Install it via pip:
Requirement already satisfied: hermes-agent in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (0.16.0) Requirement already satisfied: openai==2.24.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (2.24.0) Requirement already satisfied: certifi==2026.5.20 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (2026.5.20) Requirement already satisfied: python-dotenv==1.2.2 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (1.2.2) Requirement already satisfied: fire==0.7.1 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (0.7.1) Requirement already satisfied: httpx==0.28.1 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from httpx[socks]==0.28.1->hermes-agent) (0.28.1) Requirement already satisfied: rich==14.3.3 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (14.3.3) Requirement already satisfied: tenacity==9.1.4 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (9.1.4) Requirement already satisfied: pyyaml==6.0.3 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (6.0.3) Requirement already satisfied: ruamel.yaml==0.18.17 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (0.18.17) Requirement already satisfied: requests==2.33.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (2.33.0) Requirement already satisfied: jinja2==3.1.6 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (3.1.6) Requirement already satisfied: pydantic==2.13.4 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (2.13.4) Requirement already satisfied: prompt_toolkit==3.0.52 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (3.0.52) Requirement already satisfied: croniter==6.0.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (6.0.0) Requirement already satisfied: packaging==26.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (26.0) Requirement already satisfied: Markdown==3.10.2 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (3.10.2) Requirement already satisfied: PyJWT==2.13.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from PyJWT[crypto]==2.13.0->hermes-agent) (2.13.0) Requirement already satisfied: urllib3<3,>=2.7.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (2.7.0) Requirement already satisfied: psutil==7.2.2 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (7.2.2) Requirement already satisfied: websockets==15.0.1 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (15.0.1) Requirement already satisfied: pathspec==1.1.1 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (1.1.1) Requirement already satisfied: fastapi<1,>=0.104.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (0.133.1) Requirement already satisfied: uvicorn<1,>=0.24.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from uvicorn[standard]<1,>=0.24.0->hermes-agent) (0.41.0) Requirement already satisfied: ptyprocess<1,>=0.7.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (0.7.0) Requirement already satisfied: Pillow==12.2.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from hermes-agent) (12.2.0) Requirement already satisfied: python-dateutil in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from croniter==6.0.0->hermes-agent) (2.9.0.post0) Requirement already satisfied: pytz>2021.1 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from croniter==6.0.0->hermes-agent) (2026.2) Requirement already satisfied: termcolor in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from fire==0.7.1->hermes-agent) (3.3.0) Requirement already satisfied: anyio in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent) (4.13.0) Requirement already satisfied: httpcore==1.* in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent) (1.0.9) Requirement already satisfied: idna in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent) (3.18) Requirement already satisfied: socksio==1.* in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from httpx[socks]==0.28.1->hermes-agent) (1.0.0) Requirement already satisfied: MarkupSafe>=2.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from jinja2==3.1.6->hermes-agent) (3.0.3) Requirement already satisfied: distro<2,>=1.7.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from openai==2.24.0->hermes-agent) (1.9.0) Requirement already satisfied: jiter<1,>=0.10.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from openai==2.24.0->hermes-agent) (0.15.0) Requirement already satisfied: sniffio in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from openai==2.24.0->hermes-agent) (1.3.1) Requirement already satisfied: tqdm>4 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from openai==2.24.0->hermes-agent) (4.67.3) Requirement already satisfied: typing-extensions<5,>=4.11 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from openai==2.24.0->hermes-agent) (4.15.0) Requirement already satisfied: wcwidth in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from prompt_toolkit==3.0.52->hermes-agent) (0.7.0) Requirement already satisfied: annotated-types>=0.6.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from pydantic==2.13.4->hermes-agent) (0.7.0) Requirement already satisfied: pydantic-core==2.46.4 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from pydantic==2.13.4->hermes-agent) (2.46.4) Requirement already satisfied: typing-inspection>=0.4.2 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from pydantic==2.13.4->hermes-agent) (0.4.2) Requirement already satisfied: cryptography>=3.4.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from PyJWT[crypto]==2.13.0->hermes-agent) (48.0.0) Requirement already satisfied: charset_normalizer<4,>=2 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from requests==2.33.0->hermes-agent) (3.4.7) Requirement already satisfied: markdown-it-py>=2.2.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from rich==14.3.3->hermes-agent) (4.2.0) Requirement already satisfied: pygments<3.0.0,>=2.13.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from rich==14.3.3->hermes-agent) (2.20.0) Requirement already satisfied: ruamel.yaml.clib>=0.2.15 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from ruamel.yaml==0.18.17->hermes-agent) (0.2.15) Requirement already satisfied: h11>=0.16 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from httpcore==1.*->httpx==0.28.1->httpx[socks]==0.28.1->hermes-agent) (0.16.0) Requirement already satisfied: starlette>=0.40.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from fastapi<1,>=0.104.0->hermes-agent) (1.0.1) Requirement already satisfied: annotated-doc>=0.0.2 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from fastapi<1,>=0.104.0->hermes-agent) (0.0.4) Requirement already satisfied: click>=7.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from uvicorn<1,>=0.24.0->uvicorn[standard]<1,>=0.24.0->hermes-agent) (8.4.1) Requirement already satisfied: httptools>=0.6.3 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from uvicorn[standard]<1,>=0.24.0->hermes-agent) (0.8.0) Requirement already satisfied: uvloop>=0.15.1 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from uvicorn[standard]<1,>=0.24.0->hermes-agent) (0.22.1) Requirement already satisfied: watchfiles>=0.20 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from uvicorn[standard]<1,>=0.24.0->hermes-agent) (1.2.0) Requirement already satisfied: cffi>=2.0.0 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from cryptography>=3.4.0->PyJWT[crypto]==2.13.0->hermes-agent) (2.0.0) Requirement already satisfied: mdurl~=0.1 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from markdown-it-py>=2.2.0->rich==14.3.3->hermes-agent) (0.1.2) Requirement already satisfied: six>=1.5 in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from python-dateutil->croniter==6.0.0->hermes-agent) (1.17.0) Requirement already satisfied: pycparser in /usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages (from cffi>=2.0.0->cryptography>=3.4.0->PyJWT[crypto]==2.13.0->hermes-agent) (3.0)
Now we tell Hermes which LLM to use. For a technical founder, I recommend starting with the Hermes 3 70B model. It offers the best balance of reasoning depth and cost-efficiency.
When prompted, choose your provider. If you are using OpenRouter, you will need to provide your API key. You can find this in your OpenRouter dashboard. I typically set the model to for complex planning and for daily execution.
This is where you differentiate your agent. In Hong Kong, I often need the agent to analyze local financial data or keep track of regional tech news. I can create a "Market Intel" skill that contains the necessary documentation for local APIs or reporting standards.
To create a skill, navigate to and create a structured directory:
Inside this folder, you need a and a .
metadata.json example:
SKILL.md example: In this file, you describe the specific knowledge. For instance: "When analyzing HKEX data, always cross-reference the CCASS shareholding changes to identify institutional movement."
A terminal-only agent is useful, but a founder needs to be able to trigger actions from anywhere. The Hermes Gateway allows you to connect your agent to messaging platforms like Slack or Telegram.
⚕ Hermes Setup - Non-interactive mode
Running in a non-interactive environment (no TTY detected). The interactive wizard cannot be used here.
Configure Hermes using environment variables or config commands: hermes config set model.provider custom hermes config set model.base_url http://localhost:8080/v1 hermes config set model.default your-model-name
Or set OPENROUTER_API_KEY / OPENAI_API_KEY in your environment. Run 'hermes setup' in an interactive terminal to use the full wizard.
I personally use a private Telegram bot for my agent. It allows me to send a voice memo or a quick text while I am in a taxi heading to a meeting in Central, and have the agent start researching a topic or drafting a document before I even reach my destination.
This is the deep dive. Let us say you want your agent to monitor your company's API health. You can write a custom Python plugin that Hermes can use as a tool.
Save this file in . After a quick restart of the agent, you can literally ask: "Check the health of our staging API and report any latency over 200ms."
The most powerful feature of Hermes is its ability to remember. It maintains a long-term memory that stores facts about your business, your preferences, and past decisions. However, a founder's context changes rapidly. You must manage this memory to keep the agent sharp.
Use the following command regularly to see what your agent is keeping in mind:
Memory status ──────────────────────────────────────── Built-in: always active Provider: (none - built-in only)
Installed plugins: • byterover (requires API key) • hindsight (API key / local) • holographic (local) • honcho (API key / local) • mem0 (API key / local) • openviking (API key / local) • retaindb (API key / local) • supermemory (requires API key)
In my experience, doing a "context reset" at the start of a new quarter helps maintain the agent's peak performance if things get too noisy.
As your operations grow, a single agent will no longer suffice. For my firm, I have moved to a multi-profile architecture. In the Hermes system, profiles allow you to maintain separated environments with different skills, models, and memories. For instance, I maintain an 'Architect' profile that uses the 405B model for high-level system design, and a 'DevOps' profile that uses the 70B model with direct access to our infrastructure logs and shell.
To create a new profile, you simply use:
Profile 'devops' created at /root/.hermes/profiles/devops 73 bundled skills synced. Wrapper created: /root/.local/bin/devops
Next steps: devops setup Configure API keys and model devops chat Start chatting devops gateway start Start the messaging gateway
⚠ This profile has no API keys yet. Run 'devops setup' first, or it will inherit keys from your shell environment. Edit ~/.hermes/profiles/devops/SOUL.md to customize personality This separation is crucial for security. You do not want your public-facing customer research agent to have the same permission sets as your internal infrastructure agent. In the tech-heavy environment of Hong Kong, this modularity is what allows us to scale without introducing massive security vulnerabilities into our stacks.
The real power of skills lies in their 'active' nature. A skill can include logic that guides the agent through complex regulatory landscapes. For example, if you are building a Fintech startup in Hong Kong, you can create a 'SFC-Compliance' skill. This skill would contain the specific guidelines for automated trading systems or virtual asset service providers.
When the agent detects a task related to compliance, it loads this specific skill. This ensures that every piece of code it writes or every strategy it drafts is automatically checked against the regulatory framework you have provided. This is not just RAG; this is rule-following at the agentic level.
Let us look at the hard numbers. In Hong Kong, a junior developer or a technical researcher costs anywhere from HKD 25,000 to HKD 40,000 per month. A high-spec VPS to run a Hermes Agent fleet costs approximately HKD 1,500 per month. Even if you factor in the token costs for a high-volume 405B model, you are looking at a total cost of less than HKD 3,000 per month for an entity that works 24/7, never tires, and has access to the sum of human knowledge.
The ROI is not just in the money saved; it is in the 'opportunity cost' captured. When I can spin up a new research project in five minutes rather than five hours, I can test five times as many ideas. In the fast-paced Hong Kong startup ecosystem, that speed is often the difference between a successful Series A and a quiet closure.
A common concern for founders is the unpredictability of API costs. When an agent enters a reasoning loop, it can consume thousands of tokens in seconds. To mitigate this, I use a tiered model strategy.
This 'mixture of agents' approach can reduce your monthly token spend by up to 60% while actually increasing the quality of the final output. It is the type of strategic thinking that distinguishes a founder-led AI implementation from a generic corporate rollout.
Deployment is only the beginning. The Hermes ecosystem is incredibly active. For founders in Hong Kong, I highly recommend getting involved with the local developer communities at the Hong Kong Science Park and Cyberport. There are monthly meetups specifically focused on autonomous agents and open-source models.
Sharing custom tools and skill templates with other founders in the region allows us to build a collective intelligence that is uniquely suited to the Asian market. Whether it is a tool for translating technical Mandarin documentation or a plugin for working through the complex logistics of the Pearl River Delta, these localized components are what will give your agent-enabled business its true edge.
The technology is moving at a breakneck pace. Nous Research has already shown the potential for self-improving agents that learn from their own successes and failures. By setting up your Hermes infrastructure now, you are putting in place the foundation for these future capabilities.
As the models get smaller and more efficient, we will soon see these agents running entirely on mobile devices or edge hardware in our offices. By mastering the orchestration of these agents today, you are ensuring that your business is ready for the world of 2030, where every employee will be a manager of a digital workforce.
In a production environment running on an AWS g5.xlarge instance (using Hermes 3 70B):
Beyond the initial setup, a founder must understand the telemetry of their agentic workforce. When an agent fails, it is usually not because the 'brain' is not smart enough, but because the 'tools' or 'context' provided are inadequate. For instance, if your agent is failing to retrieve web data using the Firecrawl plugin, check your rate limits and the specificity of your search queries.
A key optimization I have discovered is 'context gardening'. Just as a garden needs weeding, your agent's long-term memory needs periodic oversight. I have an automated script that runs every Sunday evening, which asks my agent to summarize all its learnings from the past week into a structured 'Executive Briefing'. This not only provides me with a high-level overview of progress but also allows the agent to compress its memory, keeping only the most relevant insights for the week ahead.
Furthermore, consider the latency impact of your geographic location. For those of us in Hong Kong, while the temptation is to use servers in the US for cost reasons, the latency of cross-pacific API calls can significantly degrade the 'feel' of a real-time agent. Hosting your orchestrator on a local HK-based server or a Singapore-based VPS can shave 200-300ms off every turn of the reasoning loop, making the interaction feel much more natural and responsive.
Finally, let us discuss the importance of 'fallback logic'. No model is perfect. Your agentic system should always have a 'human-in-the-loop' option for high-stakes tasks. In the Hermes configuration, you can set 'approval' thresholds for certain plugin actions. For example, any action that involves a financial transaction or a public post should require a manual confirmation via the Telegram gateway. This balance of autonomy and oversight is what creates a truly resilient digital workforce.
Ultimately, deploying Hermes Agent is as much a cultural shift as it is a technical one. It requires shifting your mindset from being a 'doer' to being an 'orchestrator'. In the context of a Hong Kong startup, this means your junior staff are no longer just running errands; they are managing the agents that run the errands. This elevates the entire value chain of your organization.
I have seen firms in Central transform their entire research department by giving each analyst their own fleet of specialized agents. The analysts focus on the high-level strategy and the creative 'connect-the-dots' thinking, while the agents handle the data scraping, the sentiment analysis, and the initial drafting. The result is a more engaged workforce and a vastly superior product.
We are in a unique position in Hong Kong. We have access to global capital, a dense network of talent, and immediate proximity to the world's most advanced manufacturing hub. But we are also squeezed by high operational costs.
Automating your middle-office or technical research tasks with a private agent is not about replacing people; it is about reclaiming your time. I estimate that since deploying my own Hermes fleet, I have recovered approximately 15 hours per week that used to be spent on documentation, basic debugging, and market research.
If you are a founder at Cyberport or Science Park, do not wait for a SaaS company to sell you a locked-down version of this. Build your own. The framework is open, the models are frontier-class, and the competitive advantage is yours to take.
The gap between knowing about AI and actually using it is a chasm that many founders never cross. They wait for the perfect tool, the perfect manual, or the perfect time. But in Hong Kong, perfection is the enemy of the done.
The Hermes Agent is ready. The hardware is available. The models are smarter than ever. The only thing missing is your initiative. Take an afternoon off from your back-to-back Zoom calls. Open your terminal. Run the installation script. Start building the digital workforce that will carry your company into the next decade.
The future is not just coming; it is something you can build, right now, from the command line.
| Command | Action |
|---|---|
| ┌─────────────────────────────────────────────────────────┐ | |
| │ ⚕ Hermes Agent Status │ | |
| └─────────────────────────────────────────────────────────┘ |
◆ Environment Project: /usr/local/lib/hermes-agent Python: 3.11.15 .env file: ✓ exists Model: google/gemini-3-flash-preview Provider: Nous Portal
◆ API Keys OpenRouter ✗ (not set) OpenAI ✗ (not set) Google / Gemini ✗ (not set) DeepSeek ✗ (not set) xAI / Grok ✗ (not set) NVIDIA NIM ✗ (not set) Z.AI / GLM ✗ (not set) Kimi ✗ (not set) StepFun Step Plan ✗ (not set) MiniMax ✗ (not set) MiniMax-CN ✗ (not set) Firecrawl ✗ (not set) Tavily ✗ (not set) Browser Use ✗ (not set) Browserbase ✗ (not set) FAL ✗ (not set) ElevenLabs ✗ (not set) GitHub ✗ (not set) Anthropic ✗ (not set)
◆ Auth Providers
Nous Portal ✓ logged in
Portal URL: https://portal.nousresearch.com
Inference: https://inference-api.nousresearch.com/v1
Access exp: 2026-06-18 04:16:15 UTC
Key exp: 2026-06-18 04:16:15 UTC
Refresh: yes
OpenAI Codex ✗ not logged in (run: hermes model)
Auth file: /root/.hermes/auth.json
Error: No Codex credentials stored. Run hermes auth to authenticate.
Qwen OAuth ✗ not logged in (run: qwen auth qwen-oauth)
Auth file: /root/.qwen/oauth_creds.json
Error: Qwen CLI credentials not found. Run 'qwen auth qwen-oauth' first.
MiniMax OAuth ✗ not logged in (run: hermes auth add minimax-oauth)
xAI OAuth ✗ not logged in (run: hermes auth add xai-oauth)
Auth file: /root/.hermes/auth.json
Error: No xAI OAuth credentials stored. Select xAI Grok OAuth (SuperGrok / Premium+) in .
When we talk about 'reasoning' in agents, we're referring to the model's ability to create a DAG (Directed Acyclic Graph) of tasks and execute them sequentially. In Hermes 3, this is achieved through a sophisticated fine-tuning process that emphasizes logical consistency. When you give Hermes a complex objective-say, 'Research the top 5 competitors in the AI-driven logistics space in the GBA and draft a competitive analysis'-it doesn't just start writing. It first breaks the task into sub-tasks: 'Identify candidates', 'Scrape websites', 'Extract feature sets', 'Compare pricing', 'Generate summary'.
This internal dialogue is what makes the agent 'autonomous'. As a founder, you can monitor this dialogue in your terminal. Watching the agent realize it made a mistake, backtrack, and try a different search query is one of the most satisfying parts of using this framework. It proves that the model is not just repeating text but actually problem-solving.
Many Hong Kong businesses still rely on legacy ERP (Enterprise Resource Planning) systems or older SQL databases. One of the greatest strengths of writing custom plugins for Hermes is that you can bridge the gap between 2025 AI and 1995 infrastructure. I have written plugins for clients that allow Hermes to query 20-year-old Oracle databases, summarize the records, and then post the results into a modern Slack channel. This ability to 'wrap' legacy complexity in a modern agentic interface is a superpower for any technical leader.
The question often arises: 'Why not just use ChatGPT Plus or Enterprise?' The answer is twofold: flexibility and alignment. OpenAI's models are heavily guarded and often 'refuse' to perform certain types of technical analysis or deep-dives into edge-case data due to overly broad safety filters. Hermes, being based on the philosophy of Nous Research, is designed to be a tool, not a nanny. It is neutrally aligned, meaning it will follow your technical instructions without moralizing or lecturing you on the 'correct' way to ask a question. This is vital for professional use where you need objective data, not a sanitized corporate response.
Furthermore, the open-weight nature of Hermes means you can finetune it further on your own proprietary datasets. If you have 10 years of private company emails, board decks, and strategy documents, you can create a 'distilled' version of Hermes that understands your company's DNA better than any external model ever could. This is the true meaning of a competitive advantage in the AI era.
When we talk about 'reasoning' in agents, we're referring to the model's ability to create a DAG (Directed Acyclic Graph) of tasks and execute them sequentially. In Hermes 3, this is achieved through a sophisticated fine-tuning process that emphasizes logical consistency. When you give Hermes a complex objective-say, 'Research the top 5 competitors in the AI-driven logistics space in the GBA and draft a competitive analysis'-it doesn't just start writing. It first breaks the task into sub-tasks: 'Identify candidates', 'Scrape websites', 'Extract feature sets', 'Compare pricing', 'Generate summary'.
This internal dialogue is what makes the agent 'autonomous'. As a founder, you can monitor this dialogue in your terminal. Watching the agent realize it made a mistake, backtrack, and try a different search query is one of the most satisfying parts of using this framework. It proves that the model is not just repeating text but actually problem-solving.
Many Hong Kong businesses still rely on legacy ERP (Enterprise Resource Planning) systems or older SQL databases. One of the greatest strengths of writing custom plugins for Hermes is that you can bridge the gap between 2025 AI and 1995 infrastructure. I have written plugins for clients that allow Hermes to query 20-year-old Oracle databases, summarize the records, and then post the results into a modern Slack channel. This ability to 'wrap' legacy complexity in a modern agentic interface is a superpower for any technical leader.
The question often arises: 'Why not just use ChatGPT Plus or Enterprise?' The answer is twofold: flexibility and alignment. OpenAI's models are heavily guarded and often 'refuse' to perform certain types of technical analysis or deep-dives into edge-case data due to overly broad safety filters. Hermes, being based on the philosophy of Nous Research, is designed to be a tool, not a nanny. It is neutrally aligned, meaning it will follow your technical instructions without moralizing or lecturing you on the 'correct' way to ask a question. This is vital for professional use where you need objective data, not a sanitized corporate response.
Furthermore, the open-weight nature of Hermes means you can finetune it further on your own proprietary datasets. If you have 10 years of private company emails, board decks, and strategy documents, you can create a 'distilled' version of Hermes that understands your company's DNA better than any external model ever could. This is the true meaning of a competitive advantage in the AI era.
Filed under
Keep reading
More essays on AI growth, SEO & the web.
Once installed, we need to initialize the core configuration. This command creates the directory where your profiles and identity files will live. Many guides suggest 'hermes init', but you should explore the 'hermes setup' command for a more comprehensive configuration walkthrough.
hermes model◆ Nous Tool Gateway Nous Portal ✓ managed tools available Web tools ✓ active via Nous subscription Image generation ✓ active via Nous subscription Video generation ✓ not configured OpenAI TTS ✓ active via Nous subscription Speech-to-text ✓ active via Local faster-whisper Browser automation ✗ included by subscription, not currently selected Modal execution ✓ active via local
◆ API-Key Providers Z.AI / GLM ✗ not configured (run: hermes model) Kimi / Moonshot ✗ not configured (run: hermes model) StepFun Step Plan ✗ not configured (run: hermes model) MiniMax ✗ not configured (run: hermes model) MiniMax (China) ✗ not configured (run: hermes model)
◆ Terminal Backend Backend: local Sudo: ✗ disabled
◆ Messaging Platforms Telegram ✗ not configured Discord ✗ not configured WhatsApp ✗ not configured Signal ✗ not configured Slack ✗ not configured Email ✗ not configured SMS ✗ not configured DingTalk ✗ not configured Feishu ✗ not configured WeCom ✗ not configured WeCom Callback ✗ not configured Weixin ✗ not configured BlueBubbles ✗ not configured QQBot ✗ not configured Yuanbao ✗ not configured
◆ Gateway Service Status: ✓ running Manager: systemd (user) PID(s): 46537
◆ Scheduled Jobs Jobs: 3 active, 3 total
◆ Sessions Active: 1 session(s)
──────────────────────────────────────────────────────────── Run 'hermes doctor' for detailed diagnostics Run 'hermes setup' to configure | Check if the agent and gateway are alive | | | Install a new skill from a remote repository | | ┌─────────────────────────────────────────────────────────┐ │ 🩺 Hermes Doctor │ └─────────────────────────────────────────────────────────┘
◆ Security Advisories ✓ No active security advisories
◆ MCP Server Security ✓ No suspicious MCP stdio commands
◆ Python Environment ✓ Python 3.11.15 ✓ Virtual environment active ✓ Version files consistent (0.16.0)
◆ SSL / CA Certificates ✓ SSL CA certificate bundle is valid
◆ Required Packages ✓ OpenAI SDK ✓ Rich (terminal UI) ✓ python-dotenv ✓ PyYAML ✓ HTTPX ✓ Croniter (cron expressions) (optional) ✓ python-telegram-bot (optional) ✓ discord.py (optional)
◆ Configuration Files ✓ ~/.hermes/.env file exists ✓ API key or custom endpoint configured ✓ ~/.hermes/config.yaml exists ⚠ Config version outdated (v25 → v30) (new settings available)
◆ xAI Model Retirement (May 15, 2026) ✓ No retired xAI models in config
◆ Auth Providers
✓ Nous Portal auth (logged in)
⚠ OpenAI Codex auth (not logged in)
→ No Codex credentials stored. Run hermes auth to authenticate.
→ codex CLI not installed (optional - only required to import tokens from an existing Codex CLI login)
⚠ Google Gemini OAuth (not logged in)
⚠ MiniMax OAuth (not logged in)
⚠ xAI OAuth (not logged in)
→ No xAI OAuth credentials stored. Select xAI Grok OAuth (SuperGrok / Premium+) in hermes model.
◆ Directory Structure ✓ ~/.hermes directory exists ✓ ~/.hermes/cron/ exists ✓ ~/.hermes/sessions/ exists ✓ ~/.hermes/logs/ exists ✓ ~/.hermes/skills/ exists ✓ ~/.hermes/memories/ exists ✓ ~/.hermes/SOUL.md exists (persona configured) ✓ ~/.hermes/memories/ directory exists ✓ MEMORY.md exists (2019 chars) ✓ USER.md exists (1328 chars) ✓ ~/.hermes/state.db exists (1272 sessions)
◆ Gateway Service ✓ Systemd linger enabled (gateway service survives logout)
◆ Command Installation ✓ Venv entry point exists (venv/bin/hermes) ✗ ~/.local/bin/hermes not found (hermes command may not work outside the venv)
◆ External Tools ✓ git ✓ ripgrep (rg) (faster file search) ✓ docker (optional) ✓ Node.js ✓ agent-browser (Node.js) (browser automation) ✓ Browser tools (agent-browser) deps (no known vulnerabilities) ✓ web workspace deps (no known vulnerabilities) ✓ ui-tui workspace deps (no known vulnerabilities)
◆ API Connectivity Running 26 connectivity checks in parallel…
⚠ OpenRouter API (not configured)
◆ Tool Availability ✓ browser ✓ clarify ✓ code_execution ✓ cronjob ✓ terminal ✓ delegation ✓ file ✓ image_gen ✓ memory ✓ session_search ✓ skills ✓ todo ✓ tts ✓ video_gen ✓ vision ✓ video ✓ web ✓ kanban (runtime-gated; loaded only for dispatcher-spawned workers) ⚠ spotify (system dependency not met) ⚠ browser-cdp (system dependency not met) ⚠ computer_use (system dependency not met) ⚠ discord (missing DISCORD_BOT_TOKEN) ⚠ discord_admin (missing DISCORD_BOT_TOKEN) ⚠ feishu_doc (system dependency not met) ⚠ feishu_drive (system dependency not met) ⚠ homeassistant (system dependency not met) ⚠ moa (missing OPENROUTER_API_KEY) ⚠ x_search (missing XAI_API_KEY) ⚠ hermes-yuanbao (system dependency not met)
◆ Skills Hub ⚠ Skills Hub directory not initialized (run: hermes skills list) ⚠ No GITHUB_TOKEN (60 req/hr rate limit - set in ~/.hermes/.env for better rates)
◆ Memory Provider ✓ Built-in memory active (no external provider configured - this is fine)
◆ Profiles ✓ 1 profile(s) found ✓ devops: ⚠ missing config
──────────────────────────────────────────────────────────── Found 3 issue(s) to address:
Tip: run 'hermes doctor --fix' to auto-fix what's possible. | Run a diagnostic on your environment | | Profile Model Gateway Alias Distribution ─────────────── ─────────────────────────── ─────────── ─────────── ──────────────────── ◆default google/gemini-3-flash-prev running - - devops - stopped devops - | See all active agent identities | | ⚕ Updating Hermes Agent...
→ Fetching updates... ✓ Already up to date! | Keep your core engine up to date |
© 2026 Sheryar Shah. Engineering-led AI Growth.