Artifactiq Python SDK

Official Python SDK for the Artifactiq API.

Installation

pip install artifactiq

Quick Start

from artifactiq import Artifactiq

# Initialize client
client = Artifactiq(api_key="your_api_key")

# Analyze an image
result = client.analyze("path/to/image.jpg")

# Get detected artifacts
for artifact in result.artifacts:
    print(f"Found: {artifact.label} (confidence: {artifact.confidence:.2f})")

    # Get matching products
    products = artifact.get_products(limit=5)
    for product in products:
        print(f"  → {product.name}: ${product.price}")
        print(f"    Buy: {product.affiliate_link}")

# Get tourism packages for detected locations
if result.location_name:
    for artifact in result.artifacts:
        if artifact.type == "location":
            packages = artifact.get_tourism_packages()
            for pkg in packages:
                print(f"📍 {pkg.title}")
                for exp in pkg.experiences:
                    print(f"  - {exp.name}")

Features

• Artifact Detection - Detect objects, locations, and landmarks
• Product Matching - Get purchasable product recommendations
• Tourism Packages - Generate travel experiences
• Async Support - Async client available
• Type Safe - Full type annotations

Documentation

Full documentation available at docs.artifactiq.ai

License

MIT License - see LICENSE for details.