---
title: "Mirascope – LLM 안티프레임워크"
published: 2026-01-26T23:06:47.000Z
canonical: https://jeff.news/article/1211
---
# Mirascope – LLM 안티프레임워크

raw API의 세밀한 제어력과 고수준 프레임워크의 편의성을 동시에 제공하는 Python LLM 라이브러리. React가 HTML/CSS와 Angular 사이의 적절한 추상화인 것처럼, LLM 개발에서 같은 포지션을 노림.

- Mirascope는 스스로를 "LLM Anti-Framework"라고 부르는 Python 라이브러리임. raw provider API의 세밀한 제어력과, 고수준 에이전트 프레임워크의 타입 안전성 및 편의성을 동시에 제공하는 'Goldilocks API'를 지향함.

- 핵심 비유가 인상적임. LLM 개발에서 Mirascope는 React 같은 포지션이고, provider native API는 HTML/CSS, 기존 에이전트 프레임워크는 Angular에 해당한다는 설명임. 너무 저수준도, 너무 고수준도 아닌 딱 적절한 추상화 레벨을 노린다는 뜻임.

- 타입 안전성을 매우 중시함. API 표면뿐 아니라 내부 구현에서도 타입 안전성을 유지하며, pyright로 타입체킹을 수행함. CI에서 100% 코드 커버리지를 요구하는 것도 특징임.

- e2e 테스트에 VCR.py와 inline-snapshot을 활용해 다양한 LLM 프로바이더와의 실제 인터랙션을 리플레이하는 방식으로 검증함. 실제 API 호출을 녹화해두고 재생하는 구조라 프로바이더별 호환성을 확인할 수 있게 됨.

- 개발 환경은 uv 기반으로 세팅되며, pyright(타입체킹), ruff(린팅/포매팅), pytest(테스트) 조합으로 구성됨.

## 핵심 포인트

- Goldilocks API: raw provider API 제어력 + 에이전트 프레임워크 편의성의 중간 지점
- LLM의 React를 표방 (native API=HTML/CSS, 에이전트 프레임워크=Angular)
- 타입 안전성 중시, CI에서 100% 코드 커버리지 요구
- VCR.py + inline-snapshot으로 실제 LLM 프로바이더 인터랙션 e2e 테스트

## 인사이트

프레임워크 vs raw API 사이에서 적절한 추상화 레벨을 찾는 것은 LLM 생태계의 핵심 과제이며, React 비유는 이 포지셔닝을 효과적으로 전달함.