🎨 Kala Kaksh - AI-Powered Artisan Marketplace

Overview

Kala Kaksh is a revolutionary platform that bridges the gap between traditional Indian artisans and modern buyers through the power of AI. Our platform combines authentic handcrafted treasures with cutting-edge technology, offering AI-generated room visualizations powered by Google's Vertex AI and Imagen 3.0.

[TRY IT HERE: ] (https://eureka-hacks-kala-kaksh-k694.vercel.app/)

"Where tradition meets technology, shaping the majestic future of artisan shopping"

🏛️ Project Architecture

For better understanding of the complete project implementation, this contains the backend as well that handles core functionalities:

• Database management and API endpoints
• Product catalog and inventory management

This repository focuses on the AI-powered frontend features as well as the backend which handles core functionalities.

✨ Key Features

🎭 For Artisans

• Digital Showcase: Create beautiful profiles to display your craft and story
• Product Management: Easily add and manage your handcrafted products
• AI Enhancement: Leverage Vertex AI to enhance product descriptions
• Collaboration Network: Connect with fellow artisans for partnerships
• Story Telling: Share your artistic journey and cultural heritage

🛍️ For Buyers

• AI Room Generation: Visualize products in custom-generated rooms using Imagen 3.0
• Curated Discovery: Browse authentic handcrafted items by category
• Artisan Stories: Learn about the makers behind each product
• Smart Shopping: Cart management and purchase history
• Personalized Experience: Save preferences and wishlist items

🤖 AI-Powered Features

• Real-time Image Generation: Generate custom room designs
• Enhanced Descriptions: AI-powered product and story enhancement
• Visual Commerce: See how products look in beautifully designed spaces

📸 Screenshots

Artisan Dashboard - Collaboration Network

Connect with fellow artisans and build meaningful partnerships

AI-Generated Room Visualization

Custom room generated with traditional Indian handicrafts using Google Imagen

Buyer Shopping Experience

Discover authentic handcrafted products by category

Product Gallery with AI Visualization

Browse pottery and ceramics in AI-generated traditional settings

Welcome Experience

Beautiful introduction to the world of Indian handicrafts

🚀 Getting Started

Prerequisites

• Python 3.8 or higher
• Google Cloud Project with Vertex AI enabled
• Flask development environment

Installation

1. Clone the repository

   git clone https://github.com/yourusername/kala-kaksh.git
   cd kala-kaksh

2. Set up virtual environment

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies

   pip install -r requirements.txt

4. Configure Google Cloud

   # Set up your Google Cloud credentials
   export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/service-account-key.json"

5. Update configuration Edit app.py and update:

   PROJECT_ID = "your-google-cloud-project-id"
   LOCATION = "your-preferred-location"  # e.g., "asia-south1"

6. Run the application

   cd Kala-kaksh_genai
   python app.py

7. Access the application Open your browser and navigate to http://localhost:5000

🏗️ Project Structure

Kala-kaksh_genai/
├── app.py                  # Main Flask application
├── generate_images.py      # AI image generation utility
├── static/                 # Static assets
│   ├── style.css          # Main stylesheet
│   ├── script.js          # Client-side JavaScript
│   └── images/            # Product images
│       ├── jewellery/
│       ├── painting/
│       └── saree/
└── templates/             # HTML templates
    ├── login.html         # Authentication page
    ├── art_home.html      # Artisan dashboard
    ├── buy_home.html      # Buyer dashboard
    ├── loading.html       # AI generation loading page
    └── product_detail.html # Product gallery

🔧 Technical Stack

Backend

• Flask: Web framework for Python
• Google Vertex AI: AI/ML platform for image generation
• Imagen 3.0: State-of-the-art image generation model

Frontend

• HTML5 & CSS3: Modern web standards
• JavaScript (ES6+): Interactive functionality
• Responsive Design: Mobile-first approach

AI Integration

• Vertex AI SDK: Google Cloud AI platform integration
• Real-time Generation: Dynamic image creation
• Base64 Encoding: Efficient image data transfer

🎨 Key Pages & Functionality

Authentication System

• Google Sign-In integration
• Role-based access (Artisan/Buyer)
• Secure session management

Artisan Features

• Story Creation: art_home.html
• Product Management: Add, edit, and showcase products
• AI Enhancement: Improve descriptions with Vertex AI
• Collaboration: Connect with other artisans

Buyer Features

• Product Discovery: buy_home.html
• AI Room Generation: Visualize products in custom spaces
• Shopping Cart: Manage purchases and wishlist
• Artisan Profiles: Learn about creators

AI Integration

• Image Generation: /api/generate-realtime endpoint
• Custom Prompts: Dynamic room generation based on product types
• Real-time Processing: Live image generation and display

🌐 Product Categories

• 🥻 Handwoven Sarees: Traditional silk and cotton sarees
• 🎨 Paintings & Art: Miniature paintings, folk art, contemporary pieces
• 💎 Handcrafted Jewelry: Silver, brass, and traditional jewelry
• 🏺 Pottery & Ceramics: Terracotta, blue pottery, ceramic crafts
• 🥓 Handwoven Rugs: Traditional carpets, dhurries, floor coverings

Development Setup

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🙏 Acknowledgments

• Artisan Community: For preserving traditional crafts and inspiring this platform
• Google Cloud: For providing cutting-edge AI capabilities through Vertex AI
• Flask Community: For the robust web framework
• Open Source Contributors: For making this project possible

Made with ❤️ for preserving traditional Indian craftsmanship

"Connecting hearts through hands, bridging tradition with technology"

For detailed workflow and technical documentation, see workflow.md