(Powered by Cloudinary & Google Cloud Run)

License: MIT Contribution Welcome

Tired of juggling media files across different platforms? Need a simple, authenticated way to upload photos and videos straight to the cloud with cool transformations on the fly?

Meet the Cloud Vision Manager! 🎉

The application logic is Python and uses Flask. The first version is designed to run smoothly on Google Cloud Run, provides a lightweight file manager interface powered by the magic of Cloudinary. Log in securely via OAuth 2.0 with your Google Account and start managing your media assets with ease!

• Secure Google Sign-In: Access the manager only after authenticating with your Google Account. No complex user management needed!
• Cloudinary Uploads: Directly upload images and videos to your Cloudinary account.
• On-the-Fly Transformations: Apply basic Cloudinary transformations (resize, crop, effects) right when you upload.
• Lightweight File Management: View your uploaded Cloudinary assets directly within the app.
• Easy Viewing & Deletion: Access original files, see generated thumbnails, view applied transformations, and delete assets you no longer need.
• Cloud Run Ready: Built with a Dockerfile specifically for easy deployment on Google Cloud Run.
• Datastore Metadata: Keeps track of your uploads and associates them with your user account using Google Cloud Datastore.

• Simple Web UI: Built with Flask for a clean and straightforward user experience.
• Google Identity Services: Uses the modern GIS library for secure authentication.
• Direct Cloudinary Interaction: Leverages the official Cloudinary Python library.
• Serverless Friendly: Designed for the scale-to-zero, stateless nature of Cloud Run.
• Configurable: Uses environment variables and Google Secret Manager for secure configuration.

OAuth 2.0 Login

Upload Manager Page

Ready to launch your own Cloud Vision Manager? Here's the high-level view:

Prerequisites:

1. Google Cloud Project: You'll need a GCP project with billing enabled.
2. APIs Enabled: Ensure Cloud Run API, Cloud Build API, Artifact Registry API, Datastore API, Secret Manager API, and IAM API are enabled.
3. Cloudinary Account: Sign up at Cloudinary.com and note your Cloud Name, API Key, and API Secret.
4. Google OAuth 2.0 Client ID: Create credentials in GCP (APIs & Services -> Credentials) for a "Web application".
5. Secrets: Store your Cloudinary API Secret and a strong Flask Secret Key in Google Secret Manager.
6. gcloud CLI installed and configured.
7. Git and Docker installed locally (for building).

Quick Deployment Steps:

1. Clone the Repository: git clone https://github.com/calivision/cloudinary.git
2. Create Datastore Index: Create the required composite index for CloudinaryAsset (see index.yaml or documentation). Deploy it: gcloud datastore indexes create index.yaml --project=YOUR_PROJECT_ID and wait for it to become "Serving".
3. Configure Secrets: Create CLOUDINARY_API_SECRET and flask-secret-key in Secret Manager.
4. Build the Container: gcloud builds submit --tag REGION-docker.pkg.dev/YOUR_PROJECT_ID/YOUR_REPO/cloudinary-manager --project=YOUR_PROJECT_ID
5. Deploy to Cloud Run: Use the gcloud run deploy command, setting environment variables (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, GOOGLE_CLIENT_ID) and configuring secret access (--set-secrets=...). Assign a Service Account with Datastore User and Secret Manager Secret Accessor roles.

   # Example (replace placeholders and add other flags)
   gcloud run deploy YOUR_SERVICE_NAME \
    --image REGION-docker.pkg.dev/YOUR_PROJECT_ID/YOUR_REPO/cloudinary-manager:latest \
    --set-env-vars="GOOGLE_CLIENT_ID=YOUR_CLIENT_ID..." \
    --set-secrets="FLASK_SECRET_KEY=flask-secret-key:latest" \
    # ... other vars and secrets ...
    --service-account=YOUR_RUNTIME_SA@... \
    --allow-unauthenticated \
    --project=YOUR_PROJECT_ID --region=YOUR_REGION

6. Configure OAuth Origins: Add the deployed Cloud Run Service URL to the "Authorized JavaScript origins" in your Google OAuth Client ID settings.
7. (If Needed) Configure Public Access/IAP: If blocked by Org Policies, configure IAP or adjust policies to allow access.

➡️ Detailed Deployment Guide with Step-By-Step Instructions Will Be Posted ASAP

We're just getting started! We envision Cloud Vision Manager becoming even more useful with:

• 📱 Native Mobile Apps (Android & iOS): Securely manage credentials and access the uploader on the go!
• 🖼️ More Advanced Transformations: Integrate more of Cloudinary's powerful features.
• 📂 Folder Management: Basic folder creation/navigation within the UI.
• 🏷️ Tagging & Metadata Editing: Manage tags and metadata directly.

The Delete button throws an error, described in this known issue.

Pictures may be deleted using the Cloudinary platform after upload.

Want to help bring this vision to life? Contributions are welcome! Whether it's fixing bugs, improving the UI, adding features, or tackling the mobile apps, we'd love your input.

• Check out the Contribution Guidelines.
• Browse the Open Issues.
• Feel free to suggest new ideas!

This project is licensed under the MIT License - see the LICENSE file for details, including the use of Generative AI to create this application.

Manage media simply and securely in the cloud! 🚀