hermes - 💡(How to fix) Fix [Bug]: [Windows] read_file tool cannot access local files - "File not found" for valid D: drive paths [2 comments, 2 participants]

hermes2026-04-30 15:21:05

ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

GitHub issue URL

Helpful · Quick feedback

GitHub stats

NousResearch/hermes-agent#17999•Fetched 2026-05-01 05:54:31

View on GitHub

Comments

Participants

Timeline

Reactions

Author

wangjian202501

Participants

alt-glitch

wangjian202501

Timeline (top)

labeled ×4commented ×2

Error Message

Bug Description

On Windows, the read_file tool fails with "File not found" error even for valid file paths on D: drive. Terminal tool also fails to execute basic commands.

Steps to Reproduce

Run hermes-agent v0.11.0 on Windows 10 (native, not WSL2)
Ask: "Read the file D:\hermes jiyi\2026-04-29.md" (file exists)
Or ask: "Run hostname && whoami && pwd"

Expected Behavior

read_file should successfully read local files on D: drive
Terminal should execute basic commands like hostname

Actual Behavior

read_file returns error: "File not found" for all paths tried
Terminal returns exit_code: 1

Environment

OS: Windows 10 Pro
Hermes: v0.11.0
Python: 3.11.9
Provider: custom (Xiaomi MiMo Token Plan via token-plan-cn.xiaomimimo.com)
Terminal backend: local

Additional Context

Skills system works normally (69 skills listed and callable)
LLM calls work normally (API responding)
This suggests hermes IS running locally, but file/terminal tools have Windows-specific bugs
File paths were tested with both Chinese characters and pure ASCII - both fail
Even renamed folder to pure ASCII D:\hermes jiyi\ but still fails

Root Cause

Root Cause Analysis (optional)

Code Example

## Bug Description
On Windows, the read_file tool fails with "File not found" error even for valid file paths on D: drive. Terminal tool also fails to execute basic commands.

## Steps to Reproduce
1. Run hermes-agent v0.11.0 on Windows 10 (native, not WSL2)
2. Ask: "Read the file D:\hermes jiyi\2026-04-29.md" (file exists)
3. Or ask: "Run hostname && whoami && pwd"

## Expected Behavior
- read_file should successfully read local files on D: drive
- Terminal should execute basic commands like `hostname`

## Actual Behavior
- read_file returns error: "File not found" for all paths tried
- Terminal returns exit_code: 1

## Environment
- OS: Windows 10 Pro
- Hermes: v0.11.0
- Python: 3.11.9
- Provider: custom (Xiaomi MiMo Token Plan via token-plan-cn.xiaomimimo.com)
- Terminal backend: local

## Additional Context
- Skills system works normally (69 skills listed and callable)
- LLM calls work normally (API responding)
- This suggests hermes IS running locally, but file/terminal tools have Windows-specific bugs
- File paths were tested with both Chinese characters and pure ASCII - both fail
- Even renamed folder to pure ASCII `D:\hermes jiyi\` but still fails

---

RAW_BUFFERClick to expand / collapse

Bug Description

On Windows, the read_file tool fails with "File not found" error even for valid file paths on D: drive. Terminal tool also fails to execute basic commands.

Steps to Reproduce

Run hermes-agent v0.11.0 on Windows 10 (native, not WSL2)
Ask: "Read the file D:\hermes jiyi\2026-04-29.md" (file exists)
Or ask: "Run hostname && whoami && pwd"

Expected Behavior

read_file should successfully read local files on D: drive
Terminal should execute basic commands like hostname

Actual Behavior

read_file returns error: "File not found" for all paths tried
Terminal returns exit_code: 1

Environment

OS: Windows 10 Pro
Hermes: v0.11.0
Python: 3.11.9
Provider: custom (Xiaomi MiMo Token Plan via token-plan-cn.xiaomimimo.com)
Terminal backend: local

Additional Context

Skills system works normally (69 skills listed and callable)
LLM calls work normally (API responding)
This suggests hermes IS running locally, but file/terminal tools have Windows-specific bugs
File paths were tested with both Chinese characters and pure ASCII - both fail
Even renamed folder to pure ASCII D:\hermes jiyi\ but still fails

Steps to Reproduce

Bug Description

On Windows, the read_file tool fails with "File not found" error even for valid file paths on D: drive. Terminal tool also fails to execute basic commands.

Steps to Reproduce

Run hermes-agent v0.11.0 on Windows 10 (native, not WSL2)
Ask: "Read the file D:\hermes jiyi\2026-04-29.md" (file exists)
Or ask: "Run hostname && whoami && pwd"

Expected Behavior

read_file should successfully read local files on D: drive
Terminal should execute basic commands like hostname

Actual Behavior

read_file returns error: "File not found" for all paths tried
Terminal returns exit_code: 1

Environment

OS: Windows 10 Pro
Hermes: v0.11.0
Python: 3.11.9
Provider: custom (Xiaomi MiMo Token Plan via token-plan-cn.xiaomimimo.com)
Terminal backend: local

Additional Context

Skills system works normally (69 skills listed and callable)
LLM calls work normally (API responding)
This suggests hermes IS running locally, but file/terminal tools have Windows-specific bugs
File paths were tested with both Chinese characters and pure ASCII - both fail
Even renamed folder to pure ASCII D:\hermes jiyi\ but still fails

Expected Behavior

Bug Description

On Windows, the read_file tool fails with "File not found" error even for valid file paths on D: drive. Terminal tool also fails to execute basic commands.

Steps to Reproduce

Run hermes-agent v0.11.0 on Windows 10 (native, not WSL2)
Ask: "Read the file D:\hermes jiyi\2026-04-29.md" (file exists)
Or ask: "Run hostname && whoami && pwd"

Expected Behavior

read_file should successfully read local files on D: drive
Terminal should execute basic commands like hostname

Actual Behavior

read_file returns error: "File not found" for all paths tried
Terminal returns exit_code: 1

Environment

OS: Windows 10 Pro
Hermes: v0.11.0
Python: 3.11.9
Provider: custom (Xiaomi MiMo Token Plan via token-plan-cn.xiaomimimo.com)
Terminal backend: local

Additional Context

Skills system works normally (69 skills listed and callable)
LLM calls work normally (API responding)
This suggests hermes IS running locally, but file/terminal tools have Windows-specific bugs
File paths were tested with both Chinese characters and pure ASCII - both fail
Even renamed folder to pure ASCII D:\hermes jiyi\ but still fails

Actual Behavior

Bug Description

On Windows, the read_file tool fails with "File not found" error even for valid file paths on D: drive. Terminal tool also fails to execute basic commands.

Steps to Reproduce

Run hermes-agent v0.11.0 on Windows 10 (native, not WSL2)
Ask: "Read the file D:\hermes jiyi\2026-04-29.md" (file exists)
Or ask: "Run hostname && whoami && pwd"

Expected Behavior

read_file should successfully read local files on D: drive
Terminal should execute basic commands like hostname

Actual Behavior

read_file returns error: "File not found" for all paths tried
Terminal returns exit_code: 1

Environment

OS: Windows 10 Pro
Hermes: v0.11.0
Python: 3.11.9
Provider: custom (Xiaomi MiMo Token Plan via token-plan-cn.xiaomimimo.com)
Terminal backend: local

Additional Context

Skills system works normally (69 skills listed and callable)
LLM calls work normally (API responding)
This suggests hermes IS running locally, but file/terminal tools have Windows-specific bugs
File paths were tested with both Chinese characters and pure ASCII - both fail
Even renamed folder to pure ASCII D:\hermes jiyi\ but still fails

Affected Component

Tools (terminal, file ops, web, code execution, etc.)

Messaging Platform (if gateway-related)

No response

Debug Report

## Bug Description
On Windows, the read_file tool fails with "File not found" error even for valid file paths on D: drive. Terminal tool also fails to execute basic commands.

## Steps to Reproduce
1. Run hermes-agent v0.11.0 on Windows 10 (native, not WSL2)
2. Ask: "Read the file D:\hermes jiyi\2026-04-29.md" (file exists)
3. Or ask: "Run hostname && whoami && pwd"

## Expected Behavior
- read_file should successfully read local files on D: drive
- Terminal should execute basic commands like `hostname`

## Actual Behavior
- read_file returns error: "File not found" for all paths tried
- Terminal returns exit_code: 1

## Environment
- OS: Windows 10 Pro
- Hermes: v0.11.0
- Python: 3.11.9
- Provider: custom (Xiaomi MiMo Token Plan via token-plan-cn.xiaomimimo.com)
- Terminal backend: local

## Additional Context
- Skills system works normally (69 skills listed and callable)
- LLM calls work normally (API responding)
- This suggests hermes IS running locally, but file/terminal tools have Windows-specific bugs
- File paths were tested with both Chinese characters and pure ASCII - both fail
- Even renamed folder to pure ASCII `D:\hermes jiyi\` but still fails

Operating System

windows 10

Python Version

No response

Hermes Version

当前最新版本

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

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

extent analysis

TL;DR

The issue can be resolved by investigating the file path handling in the read_file tool and terminal backend to ensure correct interpretation of Windows file paths.

Guidance

Verify that the file paths are correctly formatted and escaped, considering Windows-specific path conventions.
Check the read_file tool and terminal backend for any platform-specific code that may be causing the issue.
Test the read_file tool and terminal backend with different file paths and commands to isolate the problem.
Consider using absolute paths or resolving any relative paths to absolute paths before passing them to the read_file tool and terminal backend.

Example

No code example is provided as the issue description lacks specific details about the implementation of the read_file tool and terminal backend.

Notes

The issue seems to be specific to the Windows platform, and the provided information suggests that the problem lies in the handling of file paths. Further investigation is needed to determine the root cause and provide a definitive fix.

Recommendation

Apply a workaround by modifying the file paths or the read_file tool and terminal backend to correctly handle Windows file paths, as the root cause of the issue is not immediately clear.

Vote matrix · Quick signals

Works

Did the solution work? Tap to confirm.

Easy Fix

Was it a quick fix?

Time Saver

Did it save you time?

Blocking

Was it severely blocking?

Common Issue

Are others likely hitting this too?

Flaky / Intermittent

Is it intermittent?

Verified / Reproducible

Can you reproduce it reliably?

#api #cache error #pipeline error #runtime error #file not found

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

hermes - 💡(How to fix) Fix [Bug]: [Windows] read_file tool cannot access local files - "File not found" for valid D: drive paths [2 comments, 2 participants]

Recommended Tools

GitHub issue graph ai analysis

Error Message

Bug Description

Steps to Reproduce

Expected Behavior

Actual Behavior

Environment

Additional Context

Root Cause

Root Cause Analysis (optional)

Code Example

Bug Description

Bug Description

Steps to Reproduce

Expected Behavior

Actual Behavior

Environment

Additional Context

Steps to Reproduce

Bug Description

Steps to Reproduce

Expected Behavior

Actual Behavior

Environment

Additional Context

Expected Behavior

Bug Description

Steps to Reproduce

Expected Behavior

Actual Behavior

Environment

Additional Context

Actual Behavior

Bug Description

Steps to Reproduce

Expected Behavior

Actual Behavior

Environment

Additional Context

Affected Component

Messaging Platform (if gateway-related)

Debug Report

Operating System

Python Version

Hermes Version

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

Proposed Fix (optional)

Are you willing to submit a PR for this?

extent analysis

TL;DR

Guidance

Example

Notes

Recommendation

Still need to ship something?

RELATED_DISCOVERY

TRENDING