Skip to main content

LLM abstractions that aren't obstructions

Project description

Tests Coverage Docs PyPI Version Stars License Stars


Mirascope is a powerful, flexible, and user-friendly library that simplifies the process of working with LLMs through a unified interface that works across various supported providers, including OpenAI, Anthropic, Mistral, Google (Gemini/Vertex), Groq, Cohere, LiteLLM, Azure AI, and Bedrock.

Whether you're generating text, extracting structured information, or developing complex AI-driven agent systems, Mirascope provides the tools you need to streamline your development process and create powerful, robust applications.

30 Second Quickstart

Install Mirascope, specifying the provider(s) you intend to use, and set your API key:

pip install "mirascope[openai]"
export OPENAI_API_KEY=XXXXX

Make your first call to an LLM to extract the title and author of a book from unstructured text:

from mirascope import llm
from pydantic import BaseModel

class Book(BaseModel):
    title: str
    author: str

@llm.call(provider="openai", model="gpt-4o-mini", response_model=Book)
def extract_book(text: str) -> str:
    return f"Extract {text}"

book = extract_book("The Name of the Wind by Patrick Rothfuss")
assert isinstance(book, Book)
print(book)
# Output: title='The Name of the Wind' author='Patrick Rothfuss'

Tutorials

Check out our quickstart tutorial and many other tutorials for an interactive way to getting started with Mirascope.

Usage

For a complete guide on how to use all of the various features Mirascope has to offer, read through our Learn documentation.

Versioning

Mirascope uses Semantic Versioning.

Licence

This project is licensed under the terms of the MIT License.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mirascope-1.25.3.tar.gz (627.2 kB view details)

Uploaded Source

Built Distribution

mirascope-1.25.3-py3-none-any.whl (373.2 kB view details)

Uploaded Python 3

File details

Details for the file mirascope-1.25.3.tar.gz.

File metadata

  • Download URL: mirascope-1.25.3.tar.gz
  • Upload date:
  • Size: 627.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.10

File hashes

Hashes for mirascope-1.25.3.tar.gz
Algorithm Hash digest
SHA256 309987dec40ab4fc7ed4961270932b314c69ad2c84d7ccfe4b277013d0e38156
MD5 e695f9de1b8a1d2f60eea628ad7f158f
BLAKE2b-256 5272b30e08bcbd895c84f4721c5b7e048556acb6a472f8de57379637c939c769

See more details on using hashes here.

File details

Details for the file mirascope-1.25.3-py3-none-any.whl.

File metadata

  • Download URL: mirascope-1.25.3-py3-none-any.whl
  • Upload date:
  • Size: 373.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.6.10

File hashes

Hashes for mirascope-1.25.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3438163fbc1c15fb07e96355d0ee0a99d978a746e355144939cefe75fe30414a
MD5 1e59de8542a17ac407d31e37e83c19b5
BLAKE2b-256 6c4d5a35c3bf341f9ae3b59b17d08a57ea1f796748bba4133add5879fb704a94

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page