Repolode
Enviar
Mirascope

Mirascope/mirascope

Toolkit para Python e TypeScript que permite chamar qualquer LLM de ponta por uma interface única, com decorators para prompts, saída estruturada e uso de ferramentas.

Ver no GitHubSite
Estrelas
1,535
Forks
153
Issues abertas
24
Último commit
anteontem

O que é?

Mirascope é uma biblioteca para trabalhar com modelos de linguagem de grande porte em Python e TypeScript. Em vez de um framework pesado com abstrações próprias, oferece uma interface única para chamar qualquer LLM de ponta, de modo que trocar de provedor geralmente se resume a mudar a string do modelo.

O principal ponto de entrada é um decorator: uma função que retorna um prompt é decorada com um identificador de modelo, como anthropic/claude-sonnet-4-5, e, ao chamar a função, você recebe um objeto de resposta. A saída pode ser analisada em um modelo Pydantic com o argumento format, e ferramentas definidas com um decorator podem ser executadas e ter seus resultados enviados de volta à conversa, criando um loop simples de agente.

O repositório é um monorepo que contém o pacote Python, a implementação em TypeScript, exemplos para ambos, o site da documentação e o conteúdo compartilhado da documentação.

Recursos principais

  • 01Chama vários provedores de LLM usando um formato único de identificador de modelo.
  • 02Define prompts como funções Python decoradas.
  • 03Analisa a saída do modelo em modelos Pydantic usando o argumento format.
  • 04Transforma funções decoradas em ferramentas e executa chamadas a ferramentas em um loop.
  • 05Oferece uma implementação em TypeScript junto com o pacote Python.

Casos de uso

  • Criar um recurso com LLM em Python que precise gerar saída JSON estruturada.
  • Escrever um agente simples que usa ferramentas sem adotar um framework grande.
  • Trocar de provedor de modelo sem reescrever os pontos de chamada.
  • Prototipar chamadas a LLM em projetos Python ou TypeScript.

Início rápido

  1. 1

    Instale o Mirascope com uv

    uv add "mirascope[all]"
  2. 2

    Chame um LLM com o decorador @llm.call e imprima a resposta

Antes de usar

  • Para chamar modelos, é necessária uma chave de API do provedor do modelo.

Em coleções

Frameworks e apps de agentes de IA open source

Tópicos

#llm#python#typescript#llm-tools#structured-output#agents#artificial-intelligence#developer-tools#llm-agent

Perguntas frequentes

O que é mirascope?
Toolkit para Python e TypeScript que permite chamar qualquer LLM de ponta por uma interface única, com decorators para prompts, saída estruturada e uso de ferramentas. Mirascope é uma biblioteca para trabalhar com modelos de linguagem de grande porte em Python e TypeScript. Em vez de um framework pesado com abstrações próprias, oferece uma interface única para chamar qualquer LLM de ponta, de modo que trocar de provedor geralmente se resume a mudar a string do modelo.
mirascope é gratuito? Qual é a licença?
mirascope é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mirascope ainda é mantido?
Manutenção ativa. O último commit de mirascope foi em 5 de nov. de 2026.
Para que posso usar mirascope?
Criar um recurso com LLM em Python que precise gerar saída JSON estruturada. Escrever um agente simples que usa ferramentas sem adotar um framework grande. Trocar de provedor de modelo sem reescrever os pontos de chamada. Prototipar chamadas a LLM em projetos Python ou TypeScript.
Como instalar mirascope?
Instale o Mirascope com uv: uv add "mirascope[all]" Chame um LLM com o decorador @llm.call e imprima a resposta
Onde consigo mirascope?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Mirascope/mirascope

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados