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) | 엔드포인트 문서 + 실제 참조하는 함수만 값으로 전달 |
| 테스트 | 픽스처 리플레이 + 게이티드 라이브 테스트 |
엔진 파이프라인 (모든 프로바이더 공통)
- 입력 JSON 스키마 검증
input.toRequest로 요청 구성 (인증 미실행 상태)- 트랜스포트가 실행하며 포트 내부에서 자격증명 주입
usage.consolidate가 원시 엔벨로프에서 사용량 정산 (출력 매핑 전)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는 툴링
개발자 워크플로
connectors/exa/레퍼런스 구현과DEVELOPMENT.md작성 가이드 읽기- 프로바이더·엔드포인트 작성
deno task record로 픽스처 기록 → 정리 후 커밋deno task check && deno task test통과 확인 (네트워크 없음)- 풀 리퀘스트 오픈
에이전트 위임 작성 지원
AGENT.md가 코딩 에이전트용 브리프 역할- Apify 액터는
deno task apify:scaffold로 입력 스키마 자동 생성
통계 (2026-10-08 기준)
- ⭐ 2.5k 스타
- 👁 89 와처
- 🍴 307 포크
- 📝 54 커밋 (main 브랜치)
관련 링크
- 웹사이트: https://monid.ai
- 문서: https://docs.monid.ai
- 도구 카탈로그: https://monid.ai/tools
- Discord: https://discord.gg/rQzztcgJV8
- X (Twitter): https://x.com/monidhq
- GitHub: https://github.com/monid-ai/monid
- 라이선스: MIT
관계
- 영감 원천: 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
요약 노트
- 2026-10-08-monid-github-repo — 이 엔티티의 원본 소스 요약 페이지