canva-data-warehouse

Local storage and organizer for kids' pictures and artwork. Import, tag, search, and generate galleries from your children's creations.

Installation

pip install canva-data-warehouse

Usage

from canva_data_warehouse import Warehouse, AgeGroup
from datetime import date

wh = Warehouse(root="./kids-pictures")

# Add a picture
wh.add("drawing.png",
       child_name="Mia",
       title="Rainbow dinosaur",
       date_created=date(2026, 3, 15),
       age_group=AgeGroup.PRESCHOOL,
       tags=["drawing", "dinosaur", "crayon"],
       medium="crayon")

# Import a whole folder
wh.add_folder("~/Photos/kids-art/", child_name="Leo")

# Query
mia_pics = wh.by_child("Mia")
dino_pics = wh.by_tag("dinosaur")
favs = wh.favorites()

# Generate HTML gallery
from canva_data_warehouse.exporter import generate_html_gallery
generate_html_gallery(wh.by_child("Mia"), "mia_gallery.html")

CLI

canva-data-warehouse add photo.jpg --child Mia --title "Beach day" --tags beach summer
canva-data-warehouse import ~/kids-art/ --child Leo
canva-data-warehouse list --child Mia
canva-data-warehouse summary
canva-data-warehouse gallery --child Mia -o mia.html

License

MIT