docs: align venv path to match installer (venv/ not .venv/)

The install script creates venv/ but several docs referenced .venv/,
causing agents to fail with 'No such file or directory' when following
AGENTS.md instructions.

Fixes #2066
This commit is contained in:
Test
2026-03-19 18:16:26 -07:00
parent 04b6ecadc4
commit 672e9752a0
5 changed files with 14 additions and 14 deletions

View File

@@ -5,7 +5,7 @@ Instructions for AI coding assistants and developers working on the hermes-agent
## Development Environment ## Development Environment
```bash ```bash
source .venv/bin/activate # ALWAYS activate before running Python source venv/bin/activate # ALWAYS activate before running Python
``` ```
## Project Structure ## Project Structure
@@ -377,7 +377,7 @@ The `_isolate_hermes_home` autouse fixture in `tests/conftest.py` redirects `HER
## Testing ## Testing
```bash ```bash
source .venv/bin/activate source venv/bin/activate
python -m pytest tests/ -q # Full suite (~3000 tests, ~3 min) python -m pytest tests/ -q # Full suite (~3000 tests, ~3 min)
python -m pytest tests/test_model_tools.py -q # Toolset resolution python -m pytest tests/test_model_tools.py -q # Toolset resolution
python -m pytest tests/test_cli_init.py -q # CLI config loading python -m pytest tests/test_cli_init.py -q # CLI config loading

View File

@@ -146,8 +146,8 @@ git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent cd hermes-agent
git submodule update --init mini-swe-agent # required terminal backend git submodule update --init mini-swe-agent # required terminal backend
curl -LsSf https://astral.sh/uv/install.sh | sh curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11 uv venv venv --python 3.11
source .venv/bin/activate source venv/bin/activate
uv pip install -e ".[all,dev]" uv pip install -e ".[all,dev]"
uv pip install -e "./mini-swe-agent" uv pip install -e "./mini-swe-agent"
python -m pytest tests/ -q python -m pytest tests/ -q

View File

@@ -16,7 +16,7 @@ Use this skill when a user asks about configuring Hermes, enabling features, set
- API keys: `~/.hermes/.env` - API keys: `~/.hermes/.env`
- Skills: `~/.hermes/skills/` - Skills: `~/.hermes/skills/`
- Hermes install: `~/.hermes/hermes-agent/` - Hermes install: `~/.hermes/hermes-agent/`
- Venv: `~/.hermes/hermes-agent/.venv/` (or `venv/`) - Venv: `~/.hermes/hermes-agent/venv/`
## CLI Overview ## CLI Overview
@@ -98,7 +98,7 @@ The interactive setup wizard walks through:
Run it from terminal: Run it from terminal:
```bash ```bash
cd ~/.hermes/hermes-agent cd ~/.hermes/hermes-agent
source .venv/bin/activate source venv/bin/activate
python -m hermes_cli.main setup python -m hermes_cli.main setup
``` ```
@@ -140,7 +140,7 @@ Voice messages from Telegram/Discord/WhatsApp/Slack/Signal are auto-transcribed
```bash ```bash
cd ~/.hermes/hermes-agent cd ~/.hermes/hermes-agent
source .venv/bin/activate # or: source venv/bin/activate source venv/bin/activate
pip install faster-whisper pip install faster-whisper
``` ```
@@ -189,7 +189,7 @@ Hermes can reply with voice when users send voice messages.
```bash ```bash
cd ~/.hermes/hermes-agent cd ~/.hermes/hermes-agent
source .venv/bin/activate source venv/bin/activate
python -m hermes_cli.main tools python -m hermes_cli.main tools
``` ```
@@ -217,7 +217,7 @@ Use `/reset` in the chat to start a fresh session with the new toolset. Tool cha
Some tools need extra packages: Some tools need extra packages:
```bash ```bash
cd ~/.hermes/hermes-agent && source .venv/bin/activate cd ~/.hermes/hermes-agent && source venv/bin/activate
pip install faster-whisper # Local STT (voice transcription) pip install faster-whisper # Local STT (voice transcription)
pip install browserbase # Browser automation pip install browserbase # Browser automation

View File

@@ -12,7 +12,7 @@ training server.
```bash ```bash
cd ~/.hermes/hermes-agent cd ~/.hermes/hermes-agent
source .venv/bin/activate source venv/bin/activate
python environments/your_env.py process \ python environments/your_env.py process \
--env.total_steps 1 \ --env.total_steps 1 \

View File

@@ -305,14 +305,14 @@ For docs-only examples, the exact file set may differ. The point is to cover:
Run tests with xdist disabled: Run tests with xdist disabled:
```bash ```bash
source .venv/bin/activate source venv/bin/activate
python -m pytest tests/test_runtime_provider_resolution.py tests/test_cli_provider_resolution.py tests/test_cli_model_command.py tests/test_setup_model_selection.py -n0 -q python -m pytest tests/test_runtime_provider_resolution.py tests/test_cli_provider_resolution.py tests/test_cli_model_command.py tests/test_setup_model_selection.py -n0 -q
``` ```
For deeper changes, run the full suite before pushing: For deeper changes, run the full suite before pushing:
```bash ```bash
source .venv/bin/activate source venv/bin/activate
python -m pytest tests/ -n0 -q python -m pytest tests/ -n0 -q
``` ```
@@ -321,14 +321,14 @@ python -m pytest tests/ -n0 -q
After tests, run a real smoke test. After tests, run a real smoke test.
```bash ```bash
source .venv/bin/activate source venv/bin/activate
python -m hermes_cli.main chat -q "Say hello" --provider your-provider --model your-model python -m hermes_cli.main chat -q "Say hello" --provider your-provider --model your-model
``` ```
Also test the interactive flows if you changed menus: Also test the interactive flows if you changed menus:
```bash ```bash
source .venv/bin/activate source venv/bin/activate
python -m hermes_cli.main model python -m hermes_cli.main model
python -m hermes_cli.main setup python -m hermes_cli.main setup
``` ```