Story IP Creator Agent

Story IP Creator Agent

By sarick-story GitHub

A demo agent using our MCP server

Overview

What is Story IP Creator Agent?

The Story IP Creator Agent is a LangGraph-based tool designed for creating, minting, and registering intellectual property (IP) assets on the Story blockchain. It utilizes AI to generate images and facilitates the entire process of IP asset creation.

How to use Story IP Creator Agent?

To use the agent, run the provided Python script after setting up the necessary environment and dependencies. Follow the interactive prompts to create and mint your IP asset.

Key features of Story IP Creator Agent?

  • AI-generated image creation using DALL-E 3
  • Uploading images to IPFS for decentralized storage
  • Minting and registering IP assets on the Story blockchain
  • Customizable licensing terms for IP assets

Use cases of Story IP Creator Agent?

  1. Creating unique digital art as IP assets
  2. Minting and licensing images for commercial use
  3. Facilitating the registration of digital assets on a blockchain

FAQ from Story IP Creator Agent?

  • Can I create any type of image?

Yes! You can create images based on your descriptions, such as characters, landscapes, or abstract art.

  • Is there a cost associated with minting IP assets?

The costs may vary based on blockchain fees and licensing terms you set.

  • What if I don't like the generated image?

You can request a new image or provide feedback to refine the generation process.

Content

Story IP Creator Agent

A LangGraph-based agent for creating, minting, and registering IP assets with Story.

Overview

This agent helps users create AI-generated images, upload them to IPFS, and register them as IP assets on the Story blockchain. The process includes:

  1. Generating an image using DALL-E 3
  2. Getting user approval for the generated image
  3. Uploading the approved image to IPFS
  4. Creating IP metadata for the IP asset
  5. Negotiating licensing terms with the user
  6. Minting and registering the IP on Story
  7. Minting license tokens for the IP

image

Requirements

  • Python 3.9+
  • LangGraph
  • LangChain
  • OpenAI API key (for DALL-E and GPT models)
  • Story SDK

Directory Structure

The agent expects a specific directory structure to function properly:

your-root-directory/
├── langgraph-mcp-agent/
│   ├── agent.py
│   └── ...
├── story-mcp-hub/          
│   ├── story-sdk-mcp/
│   │   ├── server.py
│   │   └── ...
│   └── ...

Installation

  1. Install uv:

    curl -LsSf https://astral.sh/uv/install.sh | sh

  2. Clone this repository and navigate to the project directory

  3. Install dependencies using uv:

    uv sync

  4. Set up environment variables:

    cp .env.example .env

    Then edit the .env file with your API keys and configuration.

  5. Clone the story-sdk-mcp repository into the same folder that you cloned this repository, as shown in the above Directory Structure section. Follow the README instructions to set up and install that mcp server, making sure to set up all of the .env variables. You do not have to run it, it just has to be in the same folder so this agent can access it.

Usage

Run the agent:

uv run agent.py

The agent will guide you through an interactive process to:

  1. Enter an image description (e.g., "an anime style image of a person snowboarding")
  2. Review the generated image and approve or request a new one
  3. Set licensing terms including:
    • Commercial Revenue Share percentage (0-100%)
    • Whether to allow derivative works (yes/no)
  4. Complete the minting process on the Story blockchain

Example Workflow

When you run agent.py, you'll experience a workflow like this:

=== Story IP Creator ===
This tool will help you create and mint an image as an IP asset in the Story ecosystem.

What image would you like to create? (e.g., 'an anime style image of a person snowboarding'): blob skateboarding on a mountaintop

Starting the creation process...

[Image is generated and a link is given]

Do you like this image? (yes/no + feedback): yes
Uploading image to IPFS...

[Metadata is generated]

Enter Commercial Revenue Share (0-100%, default: 15%): 20
Allow Derivative Works? (yes/no, default: yes): yes

[Minting and registration process]

=== Process Complete ===
Your IP has been successfully created and registered with Story!

The agent handles all the complex interactions with DALL-E for image generation, IPFS for storage, and the Story blockchain for minting and registration.

No tools information available.
No content found.