Hermes를 Python 라이브러리로 사용하기

Hermes를 평범한 파이썬 코드로 마음껏 부릴 수 있는 친근한 로봇 어시스턴트라고 생각해 보세요. 새로운 언어를 배우거나 화려한 대시보드를 클릭할 필요도 없답니다.

“라이브러리로 사용한다”는 게 무슨 뜻일까요?

보통 Hermes와 대화하려면 채팅 창을 이용하죠. 하지만 파이썬 라이브러리로 사용하면, Hermes에게 무엇을 할지 지시하는 파이썬 스크립트를 작성하게 됩니다. 코드 수정, 테스트 실행, 파일 정리 같은 반복적인 작업을 자동화하기에 딱 좋아요.

첫 명령: 검색 및 패치

업데이트가 필요한 오래된 API 호출이 있는 큰 프로젝트가 있다고 가정해 볼게요. 각 파일을 수동으로 열지 않고, 모든 파일을 찾아서 고쳐 주는 스크립트를 작성할 수 있습니다:

# Find all Python files using deprecated API and fix them
matches = search_files("old_api_call", path="src/", file_glob="*.py")
fixed = 0
for match in matches.get("matches", []):
    result = patch(
        path=match["path"],
        old_string="old_api_call(",
        new_string="new_api_call(",
        replace_all=True
    )
    if "error" not in str(result):
        fixed += 1

print(f"Fixed {fixed} files out of {len(matches.get('matches', []))} matches")

어떤 일이 벌어지는지 볼까요? Hermes는 src/ 안의 모든 .py 파일을 검색해서 old_api_call(을 찾아 new_api_call(로 바꿔줍니다. 몇 시간 동안 해야 할 수작업을 순식간에 끝낸 거예요.

테스트 실행 및 리포트 받기

코드가 실제로 잘 작동하는지 알고 싶나요? 테스트 스위트를 실행하고 깔끔한 요약을 받을 수 있습니다:

from hermes_tools import terminal, read_file
import json

# Run tests, parse results, and report
result = terminal("cd /project && python -m pytest --tb=short -q 2>&1", timeout=120)
output = result.get("output", "")

# Parse test output
passed = output.count(" passed")
failed = output.count(" failed")
errors = output.count(" error")

report = {
    "passed": passed,
    "failed": failed,
    "errors": errors,
    "exit_code": result.get("exit_code", -1),
    "summary": output[-500:] if len(output) > 500 else output
}

print(json.dumps(report, indent=2))

이 스크립트는 테스트를 실행하고, 통과/실패 횟수를 세어 깔끔한 JSON 리포트로 출력합니다. 이 리포트를 팀원에게 자동으로 이메일로 보낼 수도 있어요.

코드 실행의 두 가지 방법

Hermes는 스크립트 실행을 위한 두 가지 “모드”를 제공합니다:

• 프로젝트 모드 (기본값): 스크립트가 프로젝트 폴더에서 실행되며, 이미 사용 중인 파이썬 환경을 그대로 사용합니다. 일상적인 작업에 가장 적합해요. 평소처럼 import pandas를 하거나 상대 경로로 파일을 읽을 수 있습니다.

• 격리 모드: 스크립트가 Hermes 자체 파이썬과 함께 분리된 격리 폴더에서 실행됩니다. 최대한 재현성을 보장하고 싶을 때 사용하세요. 예를 들어, 다른 사람과 스크립트를 공유할 때 어디서든 동일하게 실행된다는 것을 보장하고 싶은 경우죠.

설정 파일에서 모드를 전환할 수 있습니다:

# ~/.hermes/config.yaml
code_execution:
  mode: project   # or "strict"

안전 제일 (코딩할 때도)

보안에 대해 걱정하지 마세요. Hermes는 신중하게 작동합니다. 두 모드 모두에서 다음을 수행합니다:

• 스크립트 환경에서 API 키와 비밀번호를 제거합니다.
• 스크립트가 다른 Hermes 도구를 재귀적으로 호출하는 것을 차단합니다.
• 스크립트 실행 시간(최대 5분)과 출력량을 제한합니다.

마무리 및 전문가 팁

Hermes를 파이썬 라이브러리로 사용하면 지루한 작업을 한 줄짜리 스크립트로 바꿔줍니다. 작게 시작하세요. 반복적인 작업 하나(변수 이름 바꾸기나 테스트 실행 등)를 골라 자동화해 보세요.

실용적인 팁: 항상 원본이 아닌 프로젝트의 복사본에서 먼저 스크립트를 테스트하세요. 그래야 문제가 생겨도 망가뜨릴 게 없으니까요. 자신이 생기면 실제 프로젝트에 실행하세요. 자동화를 즐기세요!

---