Monid(모니드)는 **“에이전트 도구를 위한 OpenRouter”**를 표방하는 오픈소스 프로젝트다. 단일 베이스 URL과 단일 키로 AI 에이전트가 72개 이상의 프로바이더, 2,000개 이상의 도구(웹 검색·스크래핑, 인물·기업 엔리치먼트, 소셜 플랫폼, 리뷰·마켓 데이터, 비디오·이미지·음성 생성 등)에 접근할 수 있게 한다. 저장소(monid-ai/monid)는 커넥터 레이어 — 모든 엔드포인트를 선언적으로 기술하는 단일 제네릭 프레임워크 — 를 제공한다.

핵심 특징

1. 선언적 커넥터 프레임워크

  • 프로바이더(Provider): 아이덴티티, 인증, 사용량 계량 모델 선언
  • 엔드포인트(Endpoint): 요청 스키마, 입력 검증, 타임아웃, 문서 URL 선언
  • 리소스(Resource): 영구적 소유 자산의 스냅샷 형태, 라이프사이클(검증/릴리스/갱신), 사용량 요금제 정의
  • 코드 없는 순수 데이터 기술: 클라이언트, 어댑터, 프로바이더별 실행 경로 없음
  • 커넥터 추가는 풀 리퀘스트 하나로 완료; 머지 즉시 discover 카탈로그에 반영

2. 호출 단위 사용량 계량 (Per-Call Metering)

  • 엔드포인트마다 자체 사용량 모델 선언: 호출당 고정 요금, 결과당 요금, 단위당 요금(문자 수, 비디오 초 등)
  • 엔진이 원시 응답 엔벨로프에서 사용량을 정산하되, 출력 매핑 이전에 수행 → 벤더 에러, 미매칭, 미해결은 데이터로 완료되고 0원으로 정산

3. 런타임 동적 엔드포인트 선택

  • discover가 전체 카탈로그를 작업 기준으로 랭킹, 가격·실시간 헬스·p50/p95 레이턴시·더 저렴/적합한 대안 힌트 반환
  • 호출 시점에 동적으로 최적 엔드포인트 선택, 코드에 핀 고정 없음

4. 3가지 실행 모드 (단일 아티팩트)

  • 로컬: 개발자의 자체 벤더 키로 실행
  • CI: 픽스처 리플레이로 네트워크 없이 테스트
  • 호스티드 플랫폼: 자격증명이 트랜스포트 내부에서 주입, 엔진 프로세스에 진입 안 함

기술 스택

영역기술
런타임Deno 2.x (TypeScript 네이티브)
스키마 검증Zod (런타임 + 컴파일타임)
함수 인터닝콘텐츠 해시 기반(git-blob 스타일), 탬퍼 체크 겸용
실드 유닛(Sealed Unit)엔드포인트 문서 + 실제 참조하는 함수만 값으로 전달
테스트픽스처 리플레이 + 게이티드 라이브 테스트

엔진 파이프라인 (모든 프로바이더 공통)

  1. 입력 JSON 스키마 검증
  2. input.toRequest로 요청 구성 (인증 미실행 상태)
  3. 트랜스포트가 실행하며 포트 내부에서 자격증명 주입
  4. usage.consolidate가 원시 엔벨로프에서 사용량 정산 (출력 매핑 전)
  5. output.fromResponse가 결과 매핑, 최종 출력을 선언된 계약으로 검증

비-2xx 응답 처리

  • 예외가 아닌 데이터로 취급: 실행 완료, 사용량 0원 정산
  • 로드 게이트는 순서대로 닫히며(fail-closed), 계약 위반은 별도 에러 클래스로 격리

레포지토리 구조

connectors/     # 프로바이더·엔드포인트 정의 (작성 대상)
engine/         # 로드·링크·실행; 트랜스포트; 호스트 ABI
shared/core     # 계약: def, doc, hook, 번들 스키마
shared/compiler # 순수 def→doc 매핑, 함수 정규화·인터닝
shared/testing  # 실드 유닛 테스트 하네스, 픽스처 기록·리플레이
scripts/        # CLI 진입점 (compile, run, catalog, record)
openspec/       # 스펙 주도 변경; 의사결정 기록
config.yml      # schema.*, compiler.*는 계약; engine/scripts는 툴링

개발자 워크플로

  1. connectors/exa/ 레퍼런스 구현과 DEVELOPMENT.md 작성 가이드 읽기
  2. 프로바이더·엔드포인트 작성
  3. deno task record로 픽스처 기록 → 정리 후 커밋
  4. deno task check && deno task test 통과 확인 (네트워크 없음)
  5. 풀 리퀘스트 오픈

에이전트 위임 작성 지원

  • AGENT.md가 코딩 에이전트용 브리프 역할
  • Apify 액터는 deno task apify:scaffold로 입력 스키마 자동 생성

통계 (2026-10-08 기준)

  • ⭐ 2.5k 스타
  • 👁 89 와처
  • 🍴 307 포크
  • 📝 54 커밋 (main 브랜치)

관련 링크

관계

  • 영감 원천: openrouter — LLM 모델 라우팅/API 게이트웨이 (Monid는 “도구” 계층으로 확장)
  • 프로토콜: mcp — Model Context Protocol, 도구 표준화 프로토콜
  • 도메인: ai-agents — AI 에이전트 도메인 개요
  • 구현체: hermes-agent — Hermes Agent가 Monid 도구 카탈로그를 사용할 수 있음
  • 태그: ai-agents, dev-tools, open-source, typescript, deno, api-gateway

요약 노트