Error Message

I am trying to use spaCy to perform NLP tasks. Using Docker backend, terminal tool fails with OSError: [Errno 28] No space left on device when the agent attempts to execute python -m spacy download en_core_web_trf to download pre-trained model/pipeline. Based on the error stack trace, it appears python -m spacy download command internally downloads the model to tmpfs and Hermes' security hardening appears to not allow overrides on tempfs size limits.

Fix Action

PR fix notes

PR #17060: fix: resolve 7 identified issues [automated]

Repository: NousResearch/hermes-agent
Author: Sldark23
State: open | merged: False
Link: https://github.com/NousResearch/hermes-agent/pull/17060

Description (problem / solution / changelog)

Resumo / Summary

Este PR resolve 7 issues identificados no repositório Hermes Agent.

Issues Resolvidos

1. #17048 — Docker tmpfs size override

Arquivos: tools/environments/docker.py

Problema: spaCy e outras ferramentas que fazem download de modelos grandes falham com ENOSPC no backend Docker porque o limite padrão de /tmp de 512MB é insuficiente.

Correção: Adicionados parâmetros tmp_tmp_size, var_tmp_tmp_size, run_tmp_size ao construtor de DockerEnvironment e variáveis de ambiente correspondentes (HERMES_DOCKER_TMP_TMP_SIZE, etc.) para permitir ajuste fino dos limites tmpfs.

2. #17003 — MCP HTTP keepalive

Arquivos: tools/mcp_tool.py

Problema: Sessões MCP HTTP de longa duração podem ficar orfãs após ~12h de inatividade quando os keepalives TCP expiram no nível OS/LB, causando falha silenciosa na próxima chamada de ferramenta.

Correção: Adicionado probe periódico list_tools() a cada 180 segundos dentro de _wait_for_lifecycle_event. Se o probe falhar, dispara reconnect.

3. #17034 — image_edit nao exposto no toolset

Arquivos: tools/image_generation_tool.py, toolsets.py, agent/display.py, hermes_cli/tools_config.py

Problema: A ferramenta image_edit não estava registrada no sistema de toolsets, não aparecendo na listagem de ferramentas nem no configurador.

Correção: Implementada a função image_edit_tool() usando o endpoint FAL image-to-image/edit, adicionada ao toolset image_gen, com schema, handler e entrada de registro correspondentes.

4. #16964 — DingTalk file content crash

Arquivos: gateway/platforms/dingtalk.py

Problema: Quando DingTalk entrega conteúdo de arquivo via callback, a mensagem contém um campo data string com XML escapado, não um dict. O código antigo fazia json.loads(data) expecting dict, causando crash.

Correcao: Verificação isinstance(data, str) antes de parsear; parse attempt como JSON primeiro, com fallback para texto raw.

5. #17013 — QQBot duplicate session entries

Arquivos: gateway/platforms/qqbot/adapter.py

Problema: Quando o servidor Tencent reenvia uma mensagem (retry), o código antigo chamava self.session.update() a cada retry, criando entradas duplicadas no histórico.

Correcao: Adicionada verificação para pular session.update() quando o ID da mensagem é o mesmo que o último processado.

6. #16974 — Termux shebang/env fix

Arquivos: setup-hermes.sh

Problema: #!/usr/bin/env bash não funciona no Termux (bash está em /data/data/com.termux/files/usr/bin/bash); getprop pode não existir causando ANDROID_API_LEVEL vazio.

Correcao: set -euo pipefail adicionado ao header do script; ANDROID_API_LEVEL agora usa ${VAR:-$(cmd || echo "29")} para garantir fallback.

7. #16938 — API server session continuity after compression

Arquivos: gateway/platforms/api_server.py

Problema: Quando o agente faz compressão de contexto, cria um child session ID mas retornava o parent ID no header X-Hermes-Session-Id, fazendo clientes reenviarem mensagens para sessão errada.

Correcao: Chamada db.get_compression_tip() antes de carregar histórico + extração de agent.session_id do resultado para retornar o ID correto no header.

Arquivos Modificados

Arquivo	Alteracoes
`tools/environments/docker.py`	+55 linhas: tmpfs configuravel
`tools/mcp_tool.py`	+39/-4: keepalive probe
`tools/image_generation_tool.py`	+151: image_edit tool completo
`toolsets.py`	+4: image_edit no image_gen toolset
`agent/display.py`	+4: rendering image_edit
`hermes_cli/tools_config.py`	+1: listagem image_edit
`gateway/platforms/dingtalk.py`	+22: fallback text-type
`gateway/platforms/qqbot/adapter.py`	+12/-7: dedup retry
`setup-hermes.sh`	+3/-2: set -euo pipefail + ANDROID_API_LEVEL
`gateway/platforms/api_server.py`	+10/-1: compression tip + session_id

Branches: Sldark23:fix-7-issues-v2 -> NousResearch/hermes-agent:main

Changed files

REPORT-fix-7-issues-2026-04-28.md (added, +178/-0)
agent/display.py (modified, +3/-1)
agent/file_safety.py (modified, +83/-1)
cli.py (modified, +6/-2)
gateway/platforms/api_server.py (modified, +10/-1)
gateway/platforms/dingtalk.py (modified, +22/-0)
gateway/platforms/discord.py (modified, +165/-6)
gateway/platforms/qqbot/adapter.py (modified, +12/-7)
gateway/run.py (modified, +22/-2)
hermes_cli/tools_config.py (modified, +1/-1)
run_agent.py (modified, +2/-1)
setup-hermes.sh (modified, +3/-2)
tools/environments/docker.py (modified, +76/-4)
tools/image_generation_tool.py (modified, +151/-0)
tools/mcp_tool.py (modified, +39/-4)
toolsets.py (modified, +2/-2)

Problem or Use Case

Hi,

Please consider the ability to allow users to override containers' tempfs settings via config.yaml.

Proposed Solution

Add container_tempfs_tmp_size (default to 512MB), container_tempfs_var_tmp_size (default to 256MB), container_tempfs_run_size (default to 64MB) to config.yaml

Alternatives Considered

No response

Feature Type

Configuration option

Scope

Contribution

I'd like to implement this myself and submit a PR

Debug Report (optional)

extent analysis

TL;DR

Increase the tempfs size limits in the Docker container to prevent the "No space left on device" error when downloading spaCy models.

Guidance

The error occurs because the python -m spacy download command downloads models to tmpfs, which has limited space.
To mitigate this, consider increasing the tempfs size limits by adding configuration options to config.yaml, such as container_tempfs_tmp_size, container_tempfs_var_tmp_size, and container_tempfs_run_size.
Verify that the tempfs size limits are the cause of the issue by checking the available space in the container's tmpfs before running the python -m spacy download command.
As a temporary workaround, try downloading the spaCy models outside of the container and then copying them into the container to avoid the tmpfs size limit issue.

Example

No code example is provided as it is not clearly supported by the issue.

Notes

The proposed solution requires modifications to the config.yaml file, which may have implications for the overall system configuration and security hardening.

Recommendation

Apply workaround: increase tempfs size limits or download models outside of the container, as the issue is related to a specific configuration and not a version-specific bug.

hermes - ✅(Solved) Fix [Feature]: Add tempfs size override in config.yaml to override docker backend _SECURITY_ARGS [1 pull requests, 1 participants]

Recommended Tools

GitHub issue graph ai analysis