katachi-gen

jmsaavedra/katachi-gen

3.2

If you are the rightful owner of katachi-gen and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Katachi Gen is a platform that transforms NFT collections into unique 3D origami patterns using AI sentiment analysis and algorithmic curation.

Tools
1
Resources
0
Prompts
0

Katachi Gen - 形現

Katachi Gen transforms your NFT collection into unique 3D origami patterns through AI sentiment analysis and algorithmic curation. Each pattern reflects your personal collecting journey on ShapeL2, creating a one-of-a-kind digital origami, which can be printed and folded. A digital and physical artifact representing a snapshot of your on-chain identity.

🏆 Shapecraft2 Hackathon Submission.

🎯 Mint Your Katachi Gen NFT at katachi-gen.com

Mint Now Shape Network

Live on Shape Mainnet • Transform your on-chain journey into unique origami art

Overview

Katachi Gen transforms blockchain data into physical art. By interpreting your wallet's ShapeL2 participation data, we generate unique, foldable origami patterns that represent your on-chain journey. Each NFT is both a digital collectible and a printable origami pattern that can be brought to life. Turn your Shape into an IRL Shape.

Katachi (形) = Shape/Form in Japanese
Gen (現) = To Appear/Manifest
Together: Shape Revealed

How It Works

🎨 Shape to Shape

After logging in with a wallet holding a Shape Stack NFT:

  1. Analyzes your wallet's ShapeL2 participation including medals, collections, and all NFTs.
  2. Curates What does collecting art mean to you? What is your favorite thing about collecting on Shape? Answer this question as honestly or humorously as you'd like, and our MCP server will evaluate it for sentiment, and select 5 artworks that heuristically match your input.
  3. Generates a unique 2D origami pattern (FOLD file) with texture generated from the AI-curated set of art.
  4. Determines fold complexity based on:
    • Stack rank
    • Shape NFTs owned
    • Other MCP data points
  5. Mints an HTML file featuring an interactive 3D visualization of the folded form representing your collecting and sentiment about your journey on Shape.

🖼️ Personalized Art

Your NFT features:

  • Custom graphics representing NFTs owned by your wallet
  • Stack achievements visually incorporated into the design
  • Printable files included in token metadata for physical folding
  • Unique patterns that evolve from simple to complex based on your participation

🌐 Permanent Interactive Storage

Each Katachi Gen NFT includes two Arweave uploads:

  • Thumbnail Image - A static preview of your unique origami pattern stored permanently on Arweave
  • Interactive HTML - A fully interactive 3D visualization that lives forever on the decentralized web
    • Real-time 3D rendering of your origami pattern
    • Interactive controls for rotation, zoom, and exploration
    • Embedded metadata about your NFT collection and sentiment
    • Self-contained HTML/JavaScript that runs entirely in the browser
    • Accessible via the animation_url field in your NFT metadata

The interactive HTML files are complete web applications that allow anyone to explore your generated origami pattern in 3D, ensuring your digital art remains interactive and accessible forever through Arweave's permanent storage.

Example Live NFTs

Interactive 3D Origami Patterns

These are live examples of Katachi Gen NFTs showcasing the interactive 3D origami visualization:

🎯 View Live Example 1 | 🔗 View on Shapescan

Katachi Gen Example 1

🎯 View Live Example 2 | 🔗 View on Shapescan

Katachi Gen Example 2

Each NFT features:

  • Interactive 3D Controls: Rotate, zoom, and explore your origami pattern
  • Custom Textures: Generated from AI-curated NFTs based on your sentiment
  • Unique Patterns: Algorithmic origami forms reflecting your on-chain journey
  • Permanent Storage: Self-contained HTML stored forever on Arweave

Technical Stack

Core Technologies

  • Shape MCP Server - Accessing ShapeL2 wallet data
  • FOLD Format - Standard origami pattern specification
  • Computational Origami - Algorithmic pattern generation

Key Libraries & Resources

Project Structure

katachi-gen/
├── mcp-server/          # Shape MCP server implementation
├── generator/          # Origami pattern generation engine
├── public-site/        # Next.js frontend application
└── public/            # Static assets

AI-Powered Collection Reflection

Beyond the core origami generation, Katachi Gen features a Sentiment system that uses AI to understand collectors' emotional connections to their NFTs. This filter curates 5 NFTs from their collection to uniquely map artwork to the faces of their origami shape. Every mint will be uniquely filtered and textured based on what the collector writes at the time of minting.

How It Works

User Experience:

  1. Connected wallets can share their feelings about collecting on Shape Network
  2. The AI analyzes their sentiment and curates 5-15 NFTs from their collection that best match their emotional expression
  3. Each selected NFT includes detailed match explanations and confidence scores

AI Sentiment Analysis:

  • Emotional Theme Detection: Recognizes 10 core emotions (joy, pride, community, creativity, peace, nostalgia, adventure, wealth, nature, technology)
  • Advanced Scoring: Multi-layered algorithm analyzing text matches, thematic connections, and visual characteristics
  • Smart Curation: Ensures collection diversity by limiting to 1 NFT per collection address
  • Transparent Results: Detailed breakdowns show why each NFT matched the user's sentiment

Technical Implementation:

  • MCP Server Integration: interpretCollectionSentiment tool processes sentiment against NFT metadata
  • Comprehensive Analysis: Scores NFTs based on name matches (+3 pts), description matches (+2 pts), collection matches (+1 pt), and thematic connections
  • Visual Matching: Experimental color and mood analysis (currently metadata-based)
  • Performance Optimized: Analyzes up to 500 NFTs with Redis caching for sub-second responses

This creates a deeply personal connection between collectors and their digital art, transforming NFT browsing into an emotional journey of self-discovery.

For detailed technical specifications of the sentiment analysis algorithm, see

Smart Contract Details

Deployed Contracts

Katachi Gen is deployed on both Shape mainnet and testnet:

Contract Features

  • Owner-Controlled Minting: Currently requires owner permission (will be updated for public minting)
  • Metadata Support: Full on-chain SVG storage with rich trait metadata
  • Burnable: NFTs can be burned by their owners
  • OpenSea Compatible: Full marketplace support with proper metadata standards

Minting Process

  1. Pattern Generation: Your wallet's Shape NFT data generates a unique origami pattern
  2. SVG Creation: The pattern is rendered as an on-chain SVG with metadata
  3. Mint Transaction: Execute safeMintWithURI with auto-generated token ID
  4. Gasback Rewards: Benefit from Shape's 80% sequencer fee cashback program

Minting Eligibility

  • Requirement: Connected wallet with Shape network activity
  • Cost: Gas fees only (no mint price)
  • Limit: None - mint as many unique patterns as you want
  • Uniqueness: Each mint generates a unique pattern based on current wallet state

Cultural Inspiration

Inspired by Origami Kabuto (traditional Japanese samurai helmet), a playful origami form commonly folded by Japanese youth. Katachi Gen brings this cultural art form into the blockchain era, creating a bridge between ancient craft and modern technology.

The Vision

Every wallet tells a story through its on-chain activity. Katachi Gen transforms that story into a tangible piece of art - a unique origami form that can exist both digitally and physically, representing your journey in the Shape ecosystem.

Team

Built with ❤️ by:

Links

TODO & Future Enhancements

🎨 Enhanced Visual Analysis (High Priority)

  • Goal: Implement real computer vision for NFT artwork analysis
  • Current Limitation: System only performs text-based matching on NFT metadata
  • Desired Enhancement: Google Vision API or OpenAI Vision integration for object/color detection
  • Impact: Users mentioning "apples", "cats", etc. would get NFTs with actual visual matches

🔄 NFT Metadata Enrichment

  • Cache and enrich NFT metadata with additional data sources
  • Integrate with NFT marketplace APIs for rarity/value data
  • Enhanced collection analytics and insights

📊 Advanced Analytics Dashboard

  • Historical sentiment analysis trends for collectors
  • Collection growth insights and personal behavior patterns
  • Cross-wallet collection analysis and recommendations

🤖 Smart Collection Recommendations

  • AI-powered suggestions for new NFTs based on collection sentiment
  • Cross-collection theme analysis and pattern recognition
  • Marketplace integration for intelligent purchase recommendations

See for detailed implementation plans and technical specifications.

Transform your on-chain journey into physical art with Katachi Gen