mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-25 00:51:20 +00:00
docs: add terminal backend and windows troubleshooting
This commit is contained in:
parent
acc669645f
commit
767b5463f9
2 changed files with 52 additions and 0 deletions
|
|
@ -181,6 +181,25 @@ TERMINAL_BACKEND=docker
|
|||
TERMINAL_DOCKER_IMAGE=hermes-sandbox:latest
|
||||
```
|
||||
|
||||
### Avoid Windows Encoding Pitfalls
|
||||
|
||||
On Windows, some default encodings (such as `cp125x`) cannot represent all Unicode characters, which can cause `UnicodeEncodeError` when writing files in tests or scripts.
|
||||
|
||||
- Prefer opening files with an explicit UTF-8 encoding:
|
||||
|
||||
```python
|
||||
with open("results.txt", "w", encoding="utf-8") as f:
|
||||
f.write("✓ All good\n")
|
||||
```
|
||||
|
||||
- In PowerShell, you can also set UTF-8 as the default output encoding for your session:
|
||||
|
||||
```powershell
|
||||
$PSStyle.OutputEncoding = [Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)
|
||||
```
|
||||
|
||||
This matches how the CI environment behaves and helps avoid Windows-only failures.
|
||||
|
||||
### Review Before Choosing "Always"
|
||||
|
||||
When the agent triggers a dangerous command approval (`rm -rf`, `DROP TABLE`, etc.), you get four options: **once**, **session**, **always**, **deny**. Think carefully before choosing "always" — it permanently allowlists that pattern. Start with "session" until you're comfortable.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue