Framework ligero de Python para crear pipelines modulares de agentes de IA basados en esquemas, con Instructor y Pydantic.
Mirascope/mirascope
Un toolkit de Python y TypeScript para llamar a cualquier LLM de frontera mediante una interfaz unificada, con decoradores para prompts, salidas estructuradas y uso de herramientas.
- Estrellas
- 1,535
- Forks
- 152
- Issues abiertos
- 24
- Último commit
- ayer
¿Qué es?
Mirascope es una biblioteca para trabajar con modelos de lenguaje de gran tamaño desde Python y TypeScript. En lugar de ofrecer un framework pesado con abstracciones propias, proporciona una única interfaz para llamar a cualquier LLM de frontera, de modo que cambiar de proveedor consiste, en gran medida, en cambiar el nombre del modelo.
El punto de entrada principal es un decorador: se aplica a una función que devuelve un prompt y se configura con un identificador de modelo como anthropic/claude-sonnet-4-5; al llamar a la función, se obtiene un objeto de respuesta. La salida se puede analizar y convertir en un modelo de Pydantic mediante un argumento format. Además, las herramientas definidas con un decorador se pueden ejecutar y sus resultados se pueden incorporar de nuevo a la conversación para crear un ciclo sencillo de agente.
El repositorio es un monorepo que contiene el paquete de Python, la implementación de TypeScript, ejemplos para ambos, el sitio de documentación y el contenido compartido de la documentación.
Funciones clave
- 01Llama a varios proveedores de LLM con un formato unificado para los identificadores de modelo.
- 02Define prompts mediante funciones de Python con decoradores.
- 03Analiza la salida del modelo y la convierte en modelos de Pydantic mediante un argumento format.
- 04Convierte funciones con decoradores en herramientas y ejecuta las llamadas a estas en un ciclo.
- 05Ofrece una implementación de TypeScript junto con el paquete de Python.
Casos de uso
- Crear una funcionalidad con LLM en Python que necesite una salida JSON estructurada.
- Desarrollar un agente sencillo que use herramientas sin adoptar un framework grande.
- Cambiar de proveedor de modelos sin tener que reescribir los puntos de llamada.
- Prototipar llamadas a LLM en proyectos de Python o TypeScript.
Inicio rápido
- 1
Instala Mirascope con uv
uv add "mirascope[all]" - 2
Llama a un LLM con el decorador @llm.call e imprime la respuesta
Antes de usarlo
- Para llamar a los modelos, necesitas una clave de API del proveedor del modelo.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es mirascope?
- Un toolkit de Python y TypeScript para llamar a cualquier LLM de frontera mediante una interfaz unificada, con decoradores para prompts, salidas estructuradas y uso de herramientas. Mirascope es una biblioteca para trabajar con modelos de lenguaje de gran tamaño desde Python y TypeScript. En lugar de ofrecer un framework pesado con abstracciones propias, proporciona una única interfaz para llamar a cualquier LLM de frontera, de modo que cambiar de proveedor consiste, en gran medida, en cambiar el nombre del modelo.
- ¿mirascope es gratuito? ¿Qué licencia tiene?
- mirascope es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿mirascope sigue mantenido?
- Mantenimiento activo. El último commit de mirascope fue el 5 nov 2026.
- ¿Para qué puedo usar mirascope?
- Crear una funcionalidad con LLM en Python que necesite una salida JSON estructurada. Desarrollar un agente sencillo que use herramientas sin adoptar un framework grande. Cambiar de proveedor de modelos sin tener que reescribir los puntos de llamada. Prototipar llamadas a LLM en proyectos de Python o TypeScript.
- ¿Cómo se instala mirascope?
- Instala Mirascope con uv: uv add "mirascope[all]" Llama a un LLM con el decorador @llm.call e imprime la respuesta
- ¿Dónde consigo mirascope?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Mirascope/mirascope
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Biblioteca de Python para crear programas generativos que convierten llamadas tipadas a LLM en flujos de trabajo de IA estructurados, comprobables y con validación automática.
Framework al estilo DSPy y con prioridad en TypeScript para crear programas LLM tipados y estructurados, con agentes, flujos y optimizadores; también se compila a Python, Java, C++, Go y Rust.
Plantilla de LangGraph Studio para un agente LLM que investiga temas en la web y completa un esquema JSON definido por el usuario.
Biblioteca de Python que ofrece una interfaz única para chat, streaming, llamadas a herramientas y salidas estructuradas con distintos proveedores de IA.
BAML es un lenguaje de programación para crear agentes de IA, con funciones tipadas, un compilador basado en Rust y compatibilidad con TypeScript, Python, Go y otros lenguajes.