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, Gemini, Groq, Cohere, LiteLLM, Azure AI, Vertex 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.core import openai
from pydantic import BaseModel

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

@openai.call("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

This version

1.8.0

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.8.0.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

mirascope-1.8.0-py3-none-any.whl (256.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mirascope-1.8.0.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.14

File hashes

Hashes for mirascope-1.8.0.tar.gz
Algorithm Hash digest
SHA256 c13212d1b895bf1ed08c910e49ceb3fd56b6313a37b6dfbfd9e3f844caf528d2
MD5 a49b3b4a4496c43d6ca375eb3ca56bf5
BLAKE2b-256 d01ad7f41ba829a60a44346cbd3a32f34df6fb5c1fb6f9a61d73a631bf9d9a6e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mirascope-1.8.0-py3-none-any.whl
  • Upload date:
  • Size: 256.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.14

File hashes

Hashes for mirascope-1.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 718061786ba929e9b6dac875a6a7508a83b6ceb84e032b717f5de159acb820af
MD5 8dcb6cebf134574145329e2a5083f977
BLAKE2b-256 658d3a00ff7e205d7907fba86cd9afa3dc7489c26727c016371d1bc91adc9cd7

See more details on using hashes here.

Supported by

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