AI 에이전트를 직접 운영할 때 의외로 번거로운 부분은 모델 선택보다 인증 관리다. 제공자별 API 키를 발급하고, 로컬 설정에 넣고, 만료나 권한 문제를 따로 추적해야 한다. Nous Portal은 이 과정을 Hermes Agent 안에서 OAuth 기반 구독 연결로 다루기 위한 옵션이다.1
핵심은 “새로운 모델 앱”이라기보다 “Hermes가 관리하는 제공자 구독을 다른 도구가 쓰기 쉽게 연결하는 방식”에 가깝다.
Nous Portal은 구독을 연결하는 인증入口다
Nous Portal은 Hermes Agent 문서에서 LLM 제공자 구독을 연결하는 OAuth 기반 옵션으로 설명된다.2 사용자는 Portal OAuth 로그인을 통해 구독을 연결하고, Hermes는 이후 요청에 필요한 자격 증명을 붙여 LLM 제공자와 통신한다.
즉, 사용자가 여러 곳에 정적 API 키를 직접 배치하는 구조를 줄이는 것이 목적이다. Nous Portal OAuth 로그인은 다음 명령으로 시작할 수 있다.2
hermes auth add nousHermes는 Nous Portal OAuth refresh token을 ~/.hermes/auth.json에 저장한다.2 이 점은 편의성과 함께 보안상 중요한 의미를 갖는다. 해당 파일은 단순 설정값이 아니라 구독 접근과 관련된 인증 정보이므로 로컬 권한 관리 대상이 된다.
Subscription Proxy는 Portal 구독을 로컬 LLM 엔드포인트처럼 만든다
Nous Portal을 실사용 관점에서 이해하려면 Subscription Proxy를 함께 봐야 한다. Subscription Proxy는 외부 앱이 Hermes가 관리하는 제공자 구독을 LLM 엔드포인트로 사용할 수 있게 해주는 로컬 HTTP 서버다.2
특히 OpenAI 호환 chat completions를 지원하는 앱과 연동할 수 있다.2 외부 앱 입장에서는 로컬 프록시를 LLM API 엔드포인트처럼 호출하고, Hermes가 뒤에서 제공자 구독 인증을 처리하는 구조다.
이 방식의 실질적인 장점은 세 가지다.
외부 앱마다 실제 제공자 API 키를 넣지 않아도 된다.
Hermes가 정적 API 키 대신 관리 중인 자격 증명을 요청에 붙인다.
만료가 가까운 bearer 자격 증명은 자동으로 갱신된다.2
결국 Subscription Proxy는 “모델을 어디서 호출할 것인가”보다 “누가 인증을 책임질 것인가”를 바꾼다.
Hermes API 서버와 Subscription Proxy는 역할이 다르다
여기서 혼동하기 쉬운 지점이 있다. Hermes의 API 서버와 Subscription Proxy는 같은 것이 아니다.
Hermes API 서버는 에이전트의 도구, 메모리, 스킬을 제공한다.2 반면 Subscription Proxy는 원시 모델 추론만 전달하는 passthrough 구조다. 도구 호출을 실행하지 않는다.2
따라서 선택 기준은 명확하다.
Hermes Agent의 도구, 메모리, 스킬까지 쓰고 싶다면 Hermes API 서버를 봐야 한다.
기존 OpenAI 호환 앱에서 Nous Portal 구독으로 모델 호출만 하고 싶다면 Subscription Proxy가 맞다.
이 구분을 놓치면 “왜 도구 호출이 안 되지?” 같은 문제를 겪기 쉽다. Subscription Proxy는 에이전트 런타임이 아니라 모델 추론을 전달하는 프록시로 이해해야 한다.
Nous Portal의 가치는 설정 단순화에 있다
Nous Research가 Nous Portal을 소개하며 hermes portal 명령어를 언급한 것은, Hermes Agent 사용 흐름에서 Portal이 중요한 진입점이 되고 있음을 보여준다. 해당 게시물은 2026년 6월 2일 오후 5시 49분에 올라왔고, 조회수 47.7K를 기록했다.
다만 실무적으로 중요한 결론은 뉴스 자체보다 구조다. Nous Portal은 “더 많은 기능을 한 번에 제공한다”기보다, Hermes Agent와 외부 OpenAI 호환 앱 사이에서 구독 인증을 정리하는 데 초점이 있다.
처음 Hermes Agent를 설정한다면 Nous Portal OAuth 연결을 먼저 이해하는 것이 좋다. 이미 다른 LLM 앱을 쓰고 있다면 Subscription Proxy를 통해 Portal 구독을 로컬 LLM 엔드포인트처럼 연결할 수 있다. 핵심은 모델 호출보다 자격 증명 관리가 단순해진다는 점이다.
참고
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.