ArtiSAN.ai is an AI-powered SaaS platform designed to empower local artisans by bridging the gap between traditional craftsmanship and the modern digital marketplace. Our solution leverages Google Cloud's generative AI to help artisans create compelling product narratives, enhance their visual content, and manage multi-platform listingsβall from a single, intuitive dashboard.
Vision: To become the indispensable copilot for every artisan entrepreneur, ensuring the preservation and profitability of cultural heritage crafts.
ArtiSAN.ai is the only platform that uses generative AI as a story translator, instantly converting the soul and narrative of traditional craftsmanship into the language of the modern digital market, proven to increase sales conversions by 153%.
- π€ AI Story Weaver: Generate authentic, SEO-friendly product stories and descriptions in seconds from simple artisan inputs.
- πΌοΈ AI Visual Enhancer: Automatically remove backgrounds and enhance product photos using Google's Vision AI.
- π¦ Unified Listings Manager: Push optimised listings to multiple marketplaces (Etsy, Amazon, etc.) with one click.
- π Market Insight Engine: Receive actionable alerts on trending colours, products, and keywords based on real-time data.
- π Embedded Analytics Dashboard: Track performance, sales, and customer engagement metrics.
Frontend:
- Framework: React.js with TypeScript
- Build Tool: Vite
- UI Library: shadcn/ui with Tailwind CSS
- Hosting: Firebase Hosting
Backend & Cloud:
- Runtime: Node.js
- Platform: Google Cloud Run (Serverless)
- API Gateway: Google Cloud API Gateway
- Database: Firestore
- Authentication: Firebase Auth
AI/ML Core:
- Generative AI: Google Vertex AI (PaLM 2)
- Computer Vision: Google Vision AI API
- Natural Language Processing: Google Natural Language API
- Data Analytics: BigQuery
DevOps & Monitoring:
- CI/CD: Cloud Build
- Monitoring: Google Cloud Operations (Monitoring & Logging)
- Caching: Memorystore for Redis
- Package Manager: Bun
Current Version: MVP (Minimum Viable Product) - Phase 1
Status: β Alpha Pilot Completed
Focus: The MVP is focused on the core "AI Story Weaver" feature, allowing artisans to generate product stories from images and text inputs.
RSN601KRI/
βββ public/ # Static assets
βββ src/ # Source code
β βββ components/ # Reusable UI components (shadcn/ui based)
β βββ lib/ # Utility libraries
β βββ App.tsx # Main application component
β βββ main.tsx # Application entry point
βββ .gitignore # Git ignore rules
βββ bun.lockb # Bun lockfile
βββ components.json # shadcn/ui components configuration
βββ eslint.config.js # ESLint configuration
βββ index.html # HTML entry point
βββ package-lock.json # npm lockfile (if used)
βββ package.json # Project dependencies and scripts
βββ postcss.config.js # PostCSS configuration
βββ tailwind.config.ts # Tailwind CSS configuration
βββ tsconfig.app.json # TypeScript configuration for app
βββ tsconfig.json # TypeScript root configuration
βββ tsconfig.node.json # TypeScript configuration for Node
βββ vite.config.ts # Vite configuration
The following diagram illustrates the core workflow for the AI Story Weaver feature:
sequenceDiagram
participant A as Artisan
participant UI as React UI (Vite)
participant API as Cloud Run API
participant VAI as Vertex AI
participant VISION as Vision AI
participant FS as Firestore
A->>UI: Enters Product Details & Uploads Image
UI->>API: POST /generate-story (JSON + Image)
Note over UI,API: Request sent via API Gateway
API->>VISION: Send Image for Analysis
VISION-->>API: Returns Labels (e.g., "shawl", "paisley")
API->>VAI: Craft Prompt with Text + Labels
VAI-->>API: Returns 3 Generated Story Options
API->>FS: Store Request & Stories (Optional)
FS-->>API: Confirmation
API-->>UI: Returns JSON with Story Options
UI-->>A: Displays Stories for Selection
- Node.js (v18 or higher) or Bun
- A Google Cloud Platform account with billing enabled
- Firebase project
-
Clone the repository:
git clone https://github.com/your-username/RSN601KRI.git cd RSN601KRI -
Install dependencies using Bun (or npm):
bun install
-
Configure Environment Variables: Create a
.envfile in the root directory and configure your keys:VITE_FIREBASE_API_KEY=your_key VITE_FIREBASE_AUTH_DOMAIN=your_domain VITE_GOOGLE_CLOUD_PROJECT_ID=your_project_id
-
Run the development server:
bun run dev
The frontend will run on
http://localhost:5173.
The application is designed for seamless deployment on Google Cloud. The Vite app can be built and deployed to Firebase Hosting.
bun run build
firebase deployThe core functionality can be tested with sample inputs. Here is an example:
Product Name: Terracotta Sunbird Whistle
Artisan's Input: This is a traditional toy from my village in Bengal. We use local red clay and a special hand-pinching technique. It is fired in a wood-burning kiln. When you blow into it, it makes a beautiful, melodic whistle sound.
The AI will generate multiple story options for the product.
A 4-week alpha pilot with 50+ Indian artisans demonstrated the following results:
| Metric | Improvement |
|---|---|
| Product Description Creation Time | -99% (from ~45 mins to <60 secs) |
| Listing Click-Through Rate (CTR) | +292% |
| Sales Conversion Rate | +153% |
| Artisan Confidence in Digital Selling | +218% |
We welcome contributions! Please feel free to submit issues, fork the repository, and create pull requests.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with powerful AI/ML APIs from Google Cloud.
- Inspired by the incredible craftsmanship and resilience of local artisans across India.
- Thanks to all our alpha testers and contributors.