Skip to main content

Image and video processing for social media platforms.

Installation

pip install agoras-media

Contents

  • MediaFactory: Factory for creating Image and Video instances

  • Image: Image download, validation, and processing

  • Video: Video download, validation, and platform-specific limits

Usage

import asyncio
from agoras.media import MediaFactory, Image, Video

# Create and download images
async def download_image():
    image = Image('https://example.com/image.jpg')
    await image.download()
    # Use image.content, image.temp_file
    image.cleanup()

# Create platform-specific video
async def download_video():
    video = MediaFactory.create_video('https://example.com/video.mp4', 'facebook')
    await video.download()
    # Use video.content, video.temp_file
    video.cleanup()

# Download multiple images
async def batch_download():
    images = await MediaFactory.download_images([
        'https://example.com/image1.jpg',
        'https://example.com/image2.jpg'
    ])
    for img in images:
        print(f'Downloaded: {img.url}')
        img.cleanup()

asyncio.run(download_image())

Media constraints

Per-platform MIME, size, duration, and transfer limits live in agoras.media.constraints. Wrappers and MediaFactory import the same table; do not hardcode limits elsewhere.

To inspect limits:

agoras utils media-limits
agoras utils media-limits --platform discord --kind video

To add a platform row, edit constraints.py and run:

pytest packages/media/tests/test_constraints_contract.py

Dependencies

  • agoras-common

  • Pillow (image processing)

  • opencv-python-headless (video duration and validation)

  • filetype (file type detection)

Download files

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

Source Distribution

agoras_media-2.0.5.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agoras_media-2.0.5-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

Details for the file agoras_media-2.0.5.tar.gz.

File metadata

  • Download URL: agoras_media-2.0.5.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agoras_media-2.0.5.tar.gz
Algorithm Hash digest
SHA256 bddfdb5f0294920af989cc7fbd816b53d1cc4a1f5e2dd3159aa67c651e3ce9b7
MD5 07d6ddc81cb00a6e1d13f27af01ae0a0
BLAKE2b-256 c213025345d9cb12eb55b479a9783ab62bb8b32853d1c4298d760f33a1e00119

See more details on using hashes here.

Provenance

The following attestation bundles were made for agoras_media-2.0.5.tar.gz:

Publisher: release.yml on LuisAlejandro/agoras

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agoras_media-2.0.5-py3-none-any.whl.

File metadata

  • Download URL: agoras_media-2.0.5-py3-none-any.whl
  • Upload date:
  • Size: 15.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agoras_media-2.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c15285f791c0ccbdf522d9216ce8dc76f2967eed483ba9646e4287db912a11b0
MD5 deef140ce0873b52e5075aaf5dde8677
BLAKE2b-256 f7f61c211782698512fee7d0dd1a4a9e51ab6a7a5052250f9b5d8fcdf3df2bc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for agoras_media-2.0.5-py3-none-any.whl:

Publisher: release.yml on LuisAlejandro/agoras

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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