Mirror hermes-webtop structure and enhance Docker configuration

.github/dependabot.yml

@@ -4,8 +4,8 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
-
+ 
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      interval: "weekly"
+      interval: "weekly"

.github/workflows/docker-publish.yml

@@ -35,6 +35,17 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      # --- Free space becos the docker build is large ---
+      - name: Free Disk Space
+        uses: jlumbroso/free-disk-space@main
+        with:
+          tool-cache: true
+          android: true
+          dotnet: true
+          haskell: true
+          large-packages: true
+          swap-storage: true
+
       - name: Checkout repository
         uses: actions/checkout@v6
 

.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+**/*.pyc
+backup/**.tar.gz

Makefile

@@ -4,7 +4,8 @@ VOLUME_NAME=tradingview-agent-config
 BACKUP_FILE=tradingview-agent_config_backup.tar.gz
 BACKUP_DIR=./backup
 
-.PHONY: backup restore clean
+.PHONY: backup restore clean docker-image-clean docker-vol-clean docker-clean docker-build
+
 
 colima-start:
 	colima start --profile tradingview-agent --cpu 4 --memory 4 --disk 100
@@ -38,8 +39,10 @@ dev:
 	$(MAKE) start-locally-baked
 
 docker-image-clean:
-	# docker rm -f $$(docker ps -qa)
-	docker rm -f $(DOCKER_NAME)
+	$(MAKE) stop
+	-docker rm -f $(DOCKER_NAME)
+	-docker rmi $(DOCKER_IMAGE_NAME) ghcr.io/gitricko/$(DOCKER_IMAGE_NAME)
+
 
 docker-vol-clean:
 	docker volume rm -f $(VOLUME_NAME)
@@ -76,4 +79,4 @@ restore:
 	docker compose up -d
 
 docker-build:
-	docker build -t $(DOCKER_IMAGE_NAME)  -f ./docker/Dockerfile ./docker
+	docker build -t $(DOCKER_IMAGE_NAME)  -f ./docker/Dockerfile ./docker

README.md

@@ -2,80 +2,108 @@
 _Run TradingView Agent inside a browser-based Linux desktop with free LLM support through ModelRelay._
 
 <p align="center">
-  <strong>Your personal TradingView AI agent in the browser — no GPU required</strong>
+    <picture>
+        <img height="300" alt="tradingview-agent-title-logo" src="./docs/hermes-webtop-big.png" />
+    </picture>
 </p>
 
 <p align="center">
-<a href="LICENSE">
-    <img src="https://img.shields.io/github/license/gitricko/tradingview-agent" alt="License">
+  <strong>She will grow with you ...</strong>
+</p>
+
+<p align="center">
+<a href="https://github.com/intricko/tradingview-agent/actions/workflows/docker-publish.yml">
+    <img src="https://github.com/intricko/tradingview-agent/actions/workflows/docker-publish.yml/badge.svg" alt="Last Docker Image Push">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/github/license/intricko/tradingview-agent" alt="License">
   </a>
-  <a href="https://github.com/gitricko/tradingview-agent/issues">
-    <img src="https://img.shields.io/github/issues/gitricko/tradingview-agent" alt="GitHub issues">
+  <a href="https://github.com/intricko/tradingview-agent/issues">
+    <img src="https://img.shields.io/github/issues/intricko/tradingview-agent" alt="GitHub issues">
   </a>
 </p>
 
-**TradingView-Agent** gives you a **fully functional TradingView Agent AI assistant** in your browser in under 10 minutes — no powerful PC, no Docker on your machine, no GPU required.
+**TradingView-Agent** gives you a **fully functional TradingView AI assistant** in your browser in under 10 minutes — no powerful PC, no Docker on your machine, no GPU required.
 
-Just open this repo in a GitHub Codespace and you get:
-- A complete Ubuntu MATE desktop (WebTop)
-- CodeServer at port 8888 with Hermes Extension installed and preconfigured
+Just open this repo in a GitHub Codespace, start the container and you will get:
+- A complete Ubuntu MATE desktop (WebTop) for computer use
+- CodeServer at port 8888 with Hermes + Claude Code (cli + vscode extension) installed and preconfigured
 - Ollama server pre-installed and auto-started
-- ModelRelay pre-installed, auto-started and pre-configured as default model
-- TradingView Agent dashboard accessible via desktop launcher
+- ModelRelay pre-installed, auto-started and pre-configured as default model for Hermes and Claude Code
+- **TradingView Linux Desktop** — ready to launch from the desktop or autostart
+- Hermes gateway accessible via desktop launcher
+- [Mnemon](https://github.com/mnemon-dev/mnemon) as your Hermes default [memory provider](https://github.com/gitricko/hermes-plugin-mnemon)
 - Persistent volume for your config and settings
 
 When you're ready to go production, simply move the same Docker setup to your own machine or VPS.
 
 ## ✨ Why This Exists
 
-TradingView Agent is an AI agent framework that connects LLMs directly to your communication platforms (WhatsApp, Telegram, Slack, Discord, etc.) and can run cron jobs, spawn sub-agents, speak/listen, and give you a beautiful dashboard.
+Hermes is an AI agent framework that connects LLMs directly to your communication platforms (WhatsApp, Telegram, Slack, Discord, etc.) and can run cron jobs, spawn sub-agents, speak/listen, and give you a beautiful dashboard.
 
 The only catch? You normally need a dedicated machine with GPU.
 **TradingView-Agent removes that catch completely.**
 
 Perfect for:
 - Trying TradingView Agent risk-free
-- Free LLM APIs through [ModelRelay](https://github.com/ellipticmarketing/modelrelay)
-- Students / hackers / evaluators
-- Anyone who wants a personal AI assistant without breaking the bank
-
-## 📸 Demo
-
-(Demo video coming soon)
+- Free LLM APIs through [ModelRelay](https://github.com/ellipticmarketing/modelrelay) or [OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- Students / traders / evaluators
+- Anyone who wants a personal AI TradingView assistant without breaking the bank
 
 ## 🚀 Quick Start (5-10 minutes)
 
 1. **Open this repository in a GitHub Codespace** (big green "Code" button → Codespaces → New)
 
    It is recommended that you use 4 cpu core and 16G codespace.
 
+   <img width="900" alt="launch-codespace" src="./docs/launch-codespace.gif">
+
 3. In the Codespace terminal run:
    ```bash
    make start
    ```
+   <img width="900" alt="launch-codespace" src="./docs/make-start.gif">
+
+4. Wait ~60 seconds after first launch. It takes about 5-7 minutes if docker image is not loaded yet. When the web desktop URL appears in the Codespace Ports tab, click it.
 
-4. Wait ~60 seconds. When the web desktop URL appears in the Codespace Ports tab, click it.
+   <img width="900" alt="launch-webtop-via-ports" src="./docs/launch-webtop-via-ports.png">
+
+   __Demo on pre-installed WebApps__
+
+   <img width="900" alt="End Results" src="./docs/working-vm.gif">
 
-5. Inside the WebTop desktop:
+5. Use VSCode on Web (Code-Server) to interact wit your agents:
 
-   - You see `TradingView Agent` is already running
-   - Run `hermes` from the terminal; OR:
-   - Go to chromium at `http://localhost:9119` to access Hermes WebUI
-   - Recommendation to use CodeServer instead of WebTop
+   - Interact with files system using VSCode on the browser
+   - Interact with Hermes Agent using VSCode Extension OR via hermes-cli in the VSCode Terminal
+   - Claude Code + Hermes (both using Terminal-Cli or VSCode Extension) shared the persistent memory via [mnemon](https://github.com/mnemon-dev/mnemon)  so that Hermes remembers what you did in Claude and vice-versa.
+   - Use WebTop interface in port 3000 when you need to do computer-use 
 
+   <img width="900" alt="End Results" src="./docs/working-hermes.gif">
+
+6. Configure your Hermes with your favourite messaging app !
+
+   - Recommendation: Watch Youtube ;-)
+
+7. Last NOTE:
+   - For localhost install.. just use http://localhost:[3000,8888,9119,7352,20128]
+
 ## 🔧 Features
 
 - **Zero local install** — everything runs in browser via GitHub Codespaces
 - **Free-tier friendly** — uses ModelRelay, Ollama daily cloud credits or NVIDIA Build API fallback
 - **Persistent config** — docker volume backup and restore after Codespace recreation
 - **Easy backup/restore** — `make backup` / `make restore`
 - **One-command everything** — powerful Makefile + clean `docker-compose.yml`
-- **Auto-start ModelRelay** — Default configuration for Free LLM API
+- **Auto-start ModelRelay** — Default configuration for Free LLM API to Hermes
+- **Auto-start OmniRoute** — You need some configuration before it work but it is flexible and powerful
 - **Auto-start Ollama** — custom init script on WebTop boot
 - **Colima / local Docker support** ready
 - **Built-in code-server IDE** — browser-based VS Code on port `8888`
+- **Multiple AI VSCode Extension preinstall/config with ModelRelay** - Cline, Hermes and ClaudeCode
+- **Mnemon as default memory provider** - a knowledge store for Hermes with intent-aware recall, importance decay, and auto-deduplication
 
-## 🧑‍💻 Built-in code-server IDE
+## 🧑‍💻 Built-in code-server IDE (VSCode on the Web - Interface to Agent)
 
 This image includes `code-server` and exposes it on port `8888`.
 
@@ -87,8 +115,8 @@ This image includes `code-server` and exposes it on port `8888`.
 > Note: this setup may use `code-server --auth none` in development, so keep port `8888` private. For local production use, secure it with an authenticated reverse proxy or firewall.
 
 - Hermes Agent's Extension is preinstalled and configured in VSCode
-- Cline Extension is also preinstall and configured to ModelRelay
-- Start Hacking away in VSCode, use WebTop if you need to monitor agent do desktop-use operations. eg: Non-Headless Chrome debugging for instance.
+- Claude Code Extension is also preinstall and configured to ModelRelay
+- Start Hacking away in VSCode, use WebTop if you need to monitor agent do desktop-use operations. eg: Non-Headless Chrome debugging for instance / Linux Computer-Use
 
 ## 🔒 Security: Protected by GitHub Authentication
 
@@ -124,8 +152,8 @@ Your configuration and settings are persisted in a Docker volume.
 The project includes convenient `make` targets to back up and restore this data in codespace:
 
 ```bash
-make backup          # creates backup/tradingview-agent_config_backup.tar.gz
-make restore         # restores from backup/tradingview-agent_config_backup.tar.gz
+make backup          # creates backup/hermes_config_backup.tar.gz
+make restore         # restores from backup/hermes_config_backup.tar.gz
 ```
 
 ### When to Use It
@@ -137,7 +165,7 @@ make restore         # restores from backup/tradingview-agent_config_backup.tar.
 ### How to Migrate to a New Environment
 
 - In your current environment, run `make backup`.
-- Download the generated file: `backup/tradingview-agent_config_backup.tar.gz`.
+- Download the generated file: `backup/hermes_config_backup.tar.gz`.
 - Place the file in the `backup/` folder of the new environment.
 - Run `make restore`.
 
@@ -152,26 +180,13 @@ make build-local             # especially if you modified the ./docker/Dockerfil
 make start-locally-baked     # start from your local baked image
 ```
 
-## ⚠️ Current Limitations (honest)
-
-- GitHub Codespaces free tier has monthly limits (great for testing, less ideal for 24/7 as Codespace auto-shutdown during inactivity)
-- Ollama cloud [credits](https://ollama.com/settings) are daily — heavy use will push you to paid/local models. Or if you have multiple accounts, just `ollama signout` and `ollama signin` with different account.
-- Browser desktop has slight latency vs native (expected). You can shutdown your codespace and [change](https://docs.github.com/en/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace) to 4-core codespace to improve responsiveness or the need to run heavy applications.
-
-## 🛣️ Roadmap
-
-- [ ] More screenshots + video demo
-- [ ] Pre-built Docker image tags for stable releases
-- [ ] Community templates (Telegram-only, WhatsApp-only, etc.)
-- [ ] One-click "deploy to VPS" guide (Railway / Fly.io / cheap VPS)
-
 ## 🤝 Contributing
 
 This is a community project — every star, issue, or PR helps enormously!
 Feel free to open issues for bugs or feature requests.
 
-[![Star History Chart](https://api.star-history.com/svg?repos=gitricko/tradingview-agent&type=date&legend=top-left)](https://star-history.com/#gitricko/tradingview-agent&type=date&legend=top-left)
+[![Star History Chart](https://api.star-history.com/svg?repos=intricko/tradingview-agent&type=date&legend=top-left)](https://star-history.com/#intricko/tradingview-agent&type=date&legend=top-left)
 
 ## 📄 License
 
-MIT — see [LICENSE](./LICENSE)
+MIT — see [LICENSE](./LICENSE)

docker-compose.yml

@@ -1,3 +1,4 @@
+
 name: tradingview-agent
 services:
   tradingview-agent:
@@ -10,6 +11,7 @@ services:
     #   - seccomp:unconfined
 
     environment:
+      # - PATH=/config/.local/bin:${PATH}
       # Set your User ID and Group ID to match the host user (run 'id $USER' in your terminal)
       - PUID=${DOCKER_PUID:-501}
       - PGID=${DOCKER_PGID:-20}
@@ -26,9 +28,9 @@ services:
       - /var/run/docker.sock:/var/run/docker.sock
 
     ports:
-      # Access the Webtop GUI on port 3000 (http)
+      # Access the Webtop GUI on port 3000 (http) ~ this is turn off becos you can access via ports 3000 from code-server
       - 3000:3000
-      # tradingview-agent dashboard specific ports (adjust as needed)
+      # hermes dashboard specific ports (adjust as needed)
       - 9119:9119
       # modelrelay specific ports (adjust as needed)
       - 7352:7352
@@ -52,4 +54,4 @@ networks:
 volumes:
   tradingview-agent-config:
     external: false
-    name: tradingview-agent-config
+    name: tradingview-agent-config

docker/.claude.json

@@ -0,0 +1,9 @@
+{
+    "hasCompletedOnboarding": true,
+    "customApiKeyResponses": {
+        "approved": [
+            "sk-whatever"
+        ],
+        "rejected": []
+    }
+}

docker/CLAUDE.md

@@ -0,0 +1,3 @@
+# Session Start
+
+When the SessionStart hook reports mnemon insights available (>0), immediately run `mnemon recall "" --limit 20` to load relevant context before responding to the user.

docker/Dockerfile

@@ -1,10 +1,10 @@
-ARG HERMES_VERSION="v2026.5.7"
+ARG HERMES_VERSION="v2026.5.29.2"
 ARG OMNIROUTE_VERSION=3.7.9
 ARG MODELRELAY_VERSION=1.17.1
-ARG OLLAMA_VERSION=0.21.0
+ARG OLLAMA_VERSION=0.24.0
 ARG NODE_VERSION=24
-ARG CODE_SERVER_VERSION=4.118.0
-ARG MNEMON_VERSION=0.1.3
+ARG CODE_SERVER_VERSION=4.122.0
+ARG MNEMON_VERSION=0.1.11
 ARG TARGETARCH
 
 # Use the official Ollama image to get the binary
@@ -16,12 +16,19 @@ FROM node:${NODE_VERSION}-slim AS node-bin
 # Use your preferred Webtop flavor as the base (e.g., Ubuntu, Alpine)
 FROM lscr.io/linuxserver/webtop:ubuntu-mate
 
-# Install help utilities, Firefox, and clean up apt cache to reduce image size
-# Remove Chromium if present (webtop includes it by default)
-RUN apt-get update && \
-    apt-get install -y htop zsh wget ripgrep firefox && \
-    apt-get remove -y chromium chromium-browser chromium-common libchromium* 2>/dev/null || true && \
-    rm -rf /var/lib/apt/lists/*
+# Add gh apt repository
+ARG TARGETARCH
+RUN GH_ARCH="${GH_ARCH:-${TARGETARCH:-amd64}}"; \
+    case "${GH_ARCH}" in \
+      amd64|x86_64) GH_ARCH=amd64 ;; \
+      arm64|aarch64) GH_ARCH=arm64 ;; \
+      *) echo "Unsupported GH_ARCH: ${GH_ARCH}" >&2; exit 1 ;; \
+    esac; \
+    curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg \
+    && echo "deb [arch=${GH_ARCH} signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" > /etc/apt/sources.list.d/github-cli.list 
+
+# Install help utilities and clean up apt cache to reduce image size
+RUN apt-get update && apt-get install -y htop zsh ripgrep gh firefox && rm -rf /var/lib/apt/lists/*
 
 # Copy Node.js binaries and libraries
 COPY --from=node-bin --chown=abc:abc /usr/local/bin/node /usr/local/bin/
@@ -36,8 +43,9 @@ RUN mkdir -p /custom-cont-init.d
 COPY --chown=abc:abc *.desktop /custom-cont-init.d
 COPY --chown=abc:abc *.sh /custom-cont-init.d
 COPY --chown=abc:abc *.json /custom-cont-init.d
+COPY --chown=abc:abc *.md /custom-cont-init.d
 
-# Install Hermes Agent (TradingView Edition)
+# Install Hermes
 ARG HERMES_VERSION
 RUN curl -fsSL "https://raw.githubusercontent.com/NousResearch/hermes-agent/${HERMES_VERSION}/scripts/install.sh" | bash -s -- --skip-setup && \
     npm cache clean --force && \
@@ -46,7 +54,8 @@ RUN curl -fsSL "https://raw.githubusercontent.com/NousResearch/hermes-agent/${HE
 
 # Install ModelRelay and start automatically when desktop loads
 ARG MODELRELAY_VERSION
-RUN npm install -g modelrelay@${MODELRELAY_VERSION} && \
+# RUN npm install -g modelrelay@${MODELRELAY_VERSION} && \
+RUN npm install -g github:gitricko/modelrelay && \
     npm cache clean --force && \
     chown abc:abc -R /usr/local/lib/node_modules/modelrelay /usr/local/bin/modelrelay
 
@@ -63,7 +72,8 @@ RUN curl -fsSL https://code-server.dev/install.sh | sh -s -- --version=${CODE_SE
     ln -fs /usr/local/lib/code-server-${CODE_SERVER_VERSION} /usr/local/lib/code-server && \
     ln -fs /usr/local/lib/code-server/bin/code-server /usr/local/bin/code && \
     rm -rf ~/.cache
-COPY default.conf /defaults/default.conf
+# Uncomment this when you want to use your own default.conf to route from your reverse proxy to code-server.  I rather use codeserver to route to WebTop port 3000
+#    COPY default.conf /defaults/default.conf
 
 # Switch to the abc user and set zsh as the default shell for both root and abc
 RUN usermod -s $(which zsh) root; usermod -s $(which zsh) abc
@@ -92,7 +102,7 @@ RUN set -eux; \
 # https://www.tradingview.com/support/solutions/43000728898-how-to-install-and-update-desktop-app-on-linux/
 RUN if [ "${TARGETARCH:-amd64}" != "arm64" ]; then \
     echo "Installing TradingView Linux Desktop..." && \
-    wget -O - https://tvd-packages.tradingview.com/keyring.gpg | tee /usr/share/keyrings/tradingview-desktop-archive-keyring.gpg >/dev/null && \
+    curl -fsSL https://tvd-packages.tradingview.com/keyring.gpg | tee /usr/share/keyrings/tradingview-desktop-archive-keyring.gpg >/dev/null && \
     echo "deb [arch=amd64 signed-by=/usr/share/keyrings/tradingview-desktop-archive-keyring.gpg] https://tvd-packages.tradingview.com/ubuntu/stable jammy multiverse" | tee /etc/apt/sources.list.d/tradingview-desktop.list >/dev/null && \
     apt-get update && apt-get install -y tradingview && \
     apt-get clean && \