Skip to main content

Python SDK

Official SDK for integrating Mappa into your Python applications.

Coming Soon

The Python SDK is under development. Documentation will be available soon.

Features​

  • Pythonic interface
  • Async/await support
  • Type hints for IDE support
  • Built-in retries and error handling
  • Webhook signature verification

Installation​

pip install mappa

Quick example​

import os
from mappa import Mappa

mappa = Mappa(api_key=os.environ["MAPPA_API_KEY"])

report = mappa.reports.generate_from_url(
    url="https://example.com/recording.mp3",
    output={"template": "general_report"},
)

print(report.markdown)

Async usage​

import asyncio
from mappa import AsyncMappa

async def main():
    mappa = AsyncMappa(api_key=os.environ["MAPPA_API_KEY"])
    
    report = await mappa.reports.generate_from_url(
        url="https://example.com/recording.mp3",
        output={"template": "general_report"},
    )
    
    print(report.markdown)

asyncio.run(main())

Documentation​

Documentation coming soon:

  • Installation
  • Usage
  • Examples
  • Error Handling
  • Webhooks