Hermes Agent Workspace

Environment: macOS | Python 3 | Shared .venv

Structure

hermes/
├── .venv/              # Shared virtual environment
├── utils/              # Shared reusable code
└── [project_name]/     # Isolated project directory
    ├── main.py         # Entry point
    ├── README.md       # Short description and run command
    └── requirements.txt

Quick Commands

Do not use 'execute' tool. Only use 'terminal' tool.

1. Create a new project

mkdir project_name touch project_name/main.py project_name/README.md project_name/requirements.txt

2. Manage dependencies

source .venv/bin/activate pip install -r project_name/requirements.txt pip freeze > project_name/requirements.txt

3. Run project: always run python with the terminal tool to not have depedencies issues

python3 project_name/main.py

4. Quick look to git:

git status

5. Push to remote git

git add . git commit -m "Feat: My New Feature" git push

Core Rules

• Project Isolation: One project per folder. Never put scripts in the root.
• Shared Code: Use utils/ for common helpers only.
• Security: Never hardcode secrets. Use os.getenv() or .env files.
• Dependencies: Prefer the standard library. List external hits in requirements.txt.
• Cleanliness: Keep logs and outputs inside the project folder. Delete unused files.

Coding Standards

• Type Hints: Use them when you can.
• Tooling: Run ruff check and ruff format on your code.
• Typing: Use ty check to verify types hints.
• Testing: Write small 'test_' functions and run with pytest.
• Completion: Update the project README and commit/push your changes.

Debugging tips

• Verify you're inside /Users/hermes/python_workspace
• Verify the existence of the file you're trying to execute
• Run test with pytest
• Modify test to print usefull informations
• Add type hints, then use ty check