Visual Product Search

from mixpeek import Mixpeek

client = Mixpeek(api_key="YOUR_API_KEY")

# Create product catalog collection
collection = client.collections.create(
    namespace_id="ns_your_namespace",
    name="product_catalog",
    extractors=["multimodal-extractor", "text-extractor"]
)

# Upload product images with metadata
client.buckets.upload(
    bucket_id="bkt_products",
    url="s3://your-bucket/product-images/",
    metadata={"category": "shoes", "in_stock": True}
)

# Customer searches by photo
results = client.retrievers.execute(
    retriever_id="ret_product_search",
    query={"image_url": "https://example.com/customer-photo.jpg"},
    filters={"in_stock": True}
)

for doc in results["results"]:
    print(f"Product: {doc['metadata']['name']} - ${doc['metadata']['price']}")