개요

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

핵심 개념

커넥터 (Connector)

  • 프로바이더(Provider): 아이덴티티, 인증, 사용량 계량 모델을 선언
  • 엔드포인트(Endpoint): 요청 스키마, 입력 검증, 타임아웃, 문서 URL을 선언
  • 리소스(Resource): 영구적 소유 자산(전화번호 등)의 스냅샷 형태, 라이프사이클(검증/릴리스/갱신), 사용량 요금제를 정의

선언적 설계

  • 코드 없는 순수 데이터 기술: 클라이언트, 어댑터, 프로바이더별 실행 경로 없음
  • defineProvider / defineEndpoint 함수로 타입 안전하게 정의 (Zod 스키마 사용)
  • 커넥터 추가는 풀 리퀘스트 하나로 완료; 머지 즉시 discover 카탈로그에 반영

사용량 계량 (Usage Metering)

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

런타임 엔드포인트 선택

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

기술 스택 & 아키텍처

영역기술
런타임Deno 2.x (TypeScript 네이티브)
스키마 검증Zod (런타임 + 컴파일타임)
함수 인터닝콘텐츠 해시 기반(git-blob 스타일), 탬퍼 체크 겸용
실드 유닛(Sealed Unit)엔드포인트 문서 + 실제 참조하는 함수만 값으로 전달, 외부 스코프 차단
테스트픽스처 리플레이(네트워크 불필요) + 게이티드 라이브 테스트
CIdeno task check && deno task test — 네트워크 없이 통과 필수

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

  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가 코딩 에이전트용 브리프 역할: 레포 레이아웃, 커넥터 계약, 테스트/픽스처 워크플로, DEVELOPMENT.md 읽는 법 포함
  • Apify 액터는 deno task apify:scaffold로 입력 스키마 자동 생성 → schema/inputs.ts 생성

주요 파일

파일목적
AGENT.md코딩 에이전트용 작업 브리프
DEVELOPMENT.md훅, 컴파일러, 사용량/과금, 설정, 버저닝, 카탈로그 발행, 전체 CLI 레퍼런스
openspec/changes/*/design.md모든 설계 결정의 이유 기록 (의사결정 레코드)
config.yml스키마/컴파일러 설정 (계약 영역)
deno.json / deno.lockDeno 의존성 관리

커뮤니티 & 링크

통계 (2026-10-08 기준)

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

관련 페이지

  • openrouter — LLM 모델 라우팅/API 게이트웨이 플랫폼 (Monid의 영감 원천)
  • mcp — Model Context Protocol, 도구 표준화 프로토콜
  • ai-agents — AI 에이전트 도메인 개요