◭ Prismforge

Prismforge is an AI-native Web3 studio that turns any image into a provably unique, on-chain collectible.

Neural intelligence does the creative heavy lifting — analyzing your art, refracting its pixel signature, and pricing it — while the blockchain guarantees ownership, scarcity, and provenance. Two frontiers, one forge.

AI · Web3 · Next.js · TypeScript · Solidity · ethers.js · IPFS · IO Intelligence

---

◇ The Thesis: AI × Crypto

Most NFT platforms are just storefronts. Prismforge sits at the intersection of two of the most important frontiers in tech — generative AI and decentralized ownership — and uses each to reinforce the other:

• AI makes creation effortless. A vision model reads your image and auto-tunes the pixel-craft, then a language model writes the title, description, and suggests a fair market price. No blank canvas, no guesswork.
• Crypto makes ownership real. Every piece is minted as an ERC-721 token, so authorship, scarcity, and transfer history live on-chain — not in a database that can vanish.
• Refraction makes it unique. Prismforge subtly refracts each artwork's pixel composition before minting, giving every token a distinct on-chain fingerprint. Refract. Create. Own.

The result is a workflow where intelligence generates and the chain certifies.

◈ Features

	Feature	AI × Crypto role
🎨	Studio	Refracts any image into premium pixel-craft with live controls — the on-ramp to a unique token.
🧠	AI Assist	Vision model auto-suggests pixelation settings and generates title, description, and price.
🚀	Mint	Guided workflow to forge your art into an on-chain ERC-721 collectible.
🛍️	Marketplace	Decentralized browse / buy / sell for collectibles.
💎	Collection	Everything your wallet owns, in one place.
👤	Profile	Live wallet connection, balance, and transaction history via MetaMask.
🤖	AI Guide	A conversational Web3 concierge — wallets, minting, gas, and NFT strategy, on demand.

◆ Architecture

        ┌──────────────────────────── AI LAYER (IO Intelligence) ───────────────────────────┐
        │  Llama-3.2-90B-Vision  →  pixel-craft tuning · title · description · price          │
        │  Llama-3.3-70B-Instruct →  AI Guide concierge (chat)                                │
        └───────────────────────────────────────────────────────────────────────────────────┘
                     ▲                                                        ▲
                     │  server-side API routes (/api/*)                       │
        ┌────────────┴──────────── APP LAYER (Next.js 14 · App Router) ───────┴─────────────┐
        │  Studio · Mint · Marketplace · Collection · Profile · AI Guide                     │
        └────────────┬──────────────────────────────────────────────────────────────────────┘
                     │  ethers.js · MetaMask
        ┌────────────┴──────────── CHAIN LAYER (EVM) ───────────────────────────────────────┐
        │  PrismNFT.sol (ERC-721, OpenZeppelin)  ·  IPFS / web3.storage for metadata          │
        └───────────────────────────────────────────────────────────────────────────────────┘

◐ Tech Stack

Intelligence — IO Intelligence (io.net): Llama-3.2-90B-Vision-Instruct for image analysis, Llama-3.3-70B-Instruct for the AI Guide. Frontend — Next.js 14 (App Router), TypeScript, Tailwind CSS, shadcn/ui (Radix), Framer Motion. Chain — Solidity + OpenZeppelin ERC-721 (PrismNFT.sol), Truffle, ethers.js v6, MetaMask. Storage — IPFS / web3.storage for decentralized asset + metadata hosting.

◑ Getting Started

Prerequisites

• Node.js v18+
• npm or yarn
• Truffle (for contract work)
• MetaMask browser extension

Installation

git clone https://github.com/prismforge/prismforge.git
cd prismforge
npm install --legacy-peer-deps

Environment Variables

The AI layer is powered by IO Intelligence. Grab a free key at ai.io.net/ai/api-keys, then create a .env in the project root:

# AI layer (io.net IO Intelligence)
IO_INTELLIGENCE_API_KEY=your_api_key
IO_MODEL_ID=meta-llama/Llama-3.3-70B-Instruct

Keys are read server-side only, inside the /api routes — never exposed to the client.

Run

npm run dev

Open http://localhost:3000, connect MetaMask, and head to Studio to forge your first piece.

◒ Project Structure

prismforge/
├── app/
│   ├── api/              # AI layer — io-agent, ai-suggestions, ai-pixelate
│   ├── components/       # Header, WalletCard, BackgroundCollage
│   ├── marketplace/      # Marketplace + token detail
│   ├── my-collection/
│   ├── nft-maker/        # Mint workflow
│   ├── pixelate/         # Studio (pixel-craft engine)
│   ├── profile/          # Wallet + history
│   ├── nft-ai/           # AI Guide chat
│   ├── history/
│   ├── globals.css       # Prismforge brand system
│   └── layout.tsx
├── components/ui/        # Reusable shadcn/ui primitives
├── contracts/            # PrismNFT.sol (ERC-721)
├── migrations/           # Truffle deployment
├── hooks/ · lib/         # useToast, useMobile · cn()
├── public/               # logo, favicon, assets
└── tailwind.config.ts

◓ Smart Contract

The chain layer is PrismNFT.sol — an ERC-721 on OpenZeppelin with URI storage and per-token pricing (name Prismforge, symbol PRSM), handling minting, price updates, and metadata.

truffle compile
truffle migrate --network <your_network>

build/contracts/ is generated by truffle compile and can be regenerated anytime.

◔ Deployment (Vercel)

1. Add a .npmrc with legacy-peer-deps=true (so Vercel's install resolves peer deps).
2. Push the repo to GitHub and Import it into Vercel — Next.js is auto-detected.
3. Add IO_INTELLIGENCE_API_KEY and IO_MODEL_ID under Settings → Environment Variables.
4. Deploy. The frontend runs on Vercel; the contract deploys separately via Truffle to your chain.

◕ Roadmap — Deepening the AI × Crypto Loop

• Live on-chain minting — wire the Mint flow to PrismNFT.mintNFT + IPFS pinning.
• Contract-indexed marketplace — replace the seeded catalog with tokens read from the chain.
• AI valuation oracle — on-chain-aware price suggestions from market + rarity signals.
• Generative drops — text-to-collectible pipelines with provenance baked in.
• Creator royalties (ERC-2981) and allowlisted drops.
• Multi-wallet (WalletConnect, Coinbase Wallet) + activity feed.

◖ Contributing

Fork → branch → commit → PR. Contributions to either the AI or chain layer are welcome.

◗ License

MIT.

◭ Prismforge — intelligence generates, the chain certifies.