Users describe the influencer inside Personality.md while the application translates their choices into an IMD compatible request
COMPLETE PRODUCT MANUAL
PERSONALITY.MD
DOCUMENTATION
Personality.md is an independent application layer for designing virtual influencers and translating their creative specification into work that the IMD network can validate
PRODUCT PRINCIPLES
WHAT THE PRODUCT IS DESIGNED TO DO
The Explorer displays public jobs returned by IMD and never presents invented objectives as live work
Customer image upload is omitted and unavailable provider operations remain blocked instead of showing fictional success
Every generated image and video request includes the selected appearance voice audience values and boundaries
Users can design and validate a personality before any paid admission flow exists
The product treats virtual influencers as AI generated identities and does not present them as real people
SYSTEM MAP
ARCHITECTURE
The same-origin bridge runs through a Vercel Function in production and through Vite middleware in development Both environments reuse the same restricted request handler
FROM INFLUENCER TO LIVE TOKEN
The default Creator path joins two independent providers without hiding the boundary between them Higgsfield creates the chosen influencer motion and IMD SWARM creates the tokenized agent company only after the user explicitly continues
The user connects an Ethereum wallet signs a read-only challenge and proves the configured PMD minimum No payment approval is requested
The user supplies an identity image and a motion reference Higgsfield Genjutsu returns the real public HTTPS motion result used as the agent identity on the future website
The user chooses the agent and token name symbol company description and a whole-number pool share from 10% through 90% The current complete workflow pairs with ETH on Ethereum Mainnet
Personality.md builds the exact workflow.open request and asks the live IMD planner to verify contracts review deployment frontend IPFS hosting and launch requirements CHECK remains free
The user reviews the live quote network asset recipient amount and expiry then explicitly confirms any Permit2 approval the x402 payment signature and the EIP-712 QuoteApproval
SWARM executes the contracts deployment frontend review and publishing chain Personality.md polls the admitted workflow and only reports TOKEN + POOL + WEBSITE LIVE when a live launch repository and public website are returned
The generated request asks for a fixed supply of 1,000,000,000 tokens with 18 decimals minted once at deployment and no owner mint pause upgrade or transfer tax The launch is not automatic and no token exists until the paid SWARM workflow is admitted and completes
| LAYER | RESPONSIBILITY | CURRENT STATE |
|---|---|---|
| Landing | Product explanation agent roles and operating loop | Implemented |
| Explorer | Standalone page for real IMD jobs and network filters | Implemented |
| Personalities | Standalone index of generated vertical media examples | Implemented |
| Higgsfield Creator | Verify PMD access upload references run Genjutsu and return a real motion identity | Implemented |
| Native fairlaunch | Configure the influencer token check quote pay admit and track the complete SWARM workflow | Implemented |
| SWARM Creator | Build a separate structured influencer media request and validate its objective | Implemented |
| Bridge | Protect cross origin IMD routes behind same origin requests | Local and Vercel production |
| Payment client | Handle x402 challenge Permit2 approval two wallet signatures paid submit and status polling | Implemented |
| Persistence | Recover current IMD request tokens active orders and admitted workflow IDs within the browser session | Implemented |
PUBLIC ENTRY
HOMEPAGE
Industrial control room
The first section uses an industrial machine wall with blue indicators a large Personality.md terminal an IMD inspired desk scene and animated characters
The machinery is visual only and does not navigate to external destinations
Decorative terminal
The homepage terminal explains the agent roles but does not execute operational commands Every submitted line returns a green GO TO CREATE link that opens the Creator Studio
Influencer creation is intentionally moved away from the terminal and into the dedicated Creator Studio
Header behavior
- EXPLORER opens
/explorer.htmlin a new tab - PERSONALITIES opens
/personalities.htmlin a new tab - SWARM explains the agent roles
- PROTOCOL explains the operating loop
- DOCS opens this complete manual in a new tab
- CREATE opens the standalone Creator Studio in a new tab
- CONNECT requests wallet access only after a deliberate click
REAL NETWORK ACTIVITY
EXPLORER
The standalone Explorer lives at /explorer.html reads public jobs from IMD through GET /api/imd/jobs and renders their real objective state identifier and update time
ALL
Displays the current job page returned by IMD excluding oracle panel jobs
MEDIA
Filters objectives and templates containing video image media audio creative content visual avatar character or influencer terms
ACTIVE
Removes completed blocked failed cancelled and superseded work from the current view
The displayed count is the number of jobs received in the current request and is not presented as the total historical size of IMD
If the upstream request fails the feed shows a network unavailable state rather than replacing the jobs with mock data
STANDALONE WORKSPACE
CREATOR STUDIO
The Creator Studio lives at /create.html and contains two independent full workspaces HIGGSFIELD opens first and SWARM preserves the original IMD request builder
Sign a challenge and verify at least 100000 PMD on Ethereum Mainnet without an approval or payment
Upload one supported identity image and one MP4 motion reference no longer than five seconds
Run Higgsfield Motion Transfer and display only the real identity reference and returned video URL
Configure check quote pay and track the IMD workflow without opening the external launcher
Independent SWARM workspace
The SWARM tab keeps the original identity appearance voice behavior and first production request builder with its live request console
Changing any launch or SWARM field invalidates its earlier IMD validation and disables quote creation until that request is checked again
Token creation belongs to the generated influencer
After Higgsfield returns a real result the same workspace reveals the native fairlaunch form The user can name the influencer and token choose the symbol describe the agent company select the pool share and use the generated motion identity in the public token website
Higgsfield generation never creates a token by itself and the independent SWARM Creator tab is not the token launch form Token creation begins only inside the unlocked fairlaunch panel and continues through live IMD check quote payment admission and workflow tracking
ORIGINAL ASSET SYSTEM
VISUAL REFERENCES
Personality.md contains 21 original selector images generated specifically for this project No Higgsfield interface images are copied
| GROUP | OPTIONS | PURPOSE |
|---|---|---|
| Build | 7 | Slim athletic average curvy broad petite and plus size |
| Hairstyle | 7 | Seven eccentric sculptural fashion wigs based on the user supplied direction |
| Heritage reference | 7 | Seven diverse visual starting points for appearance direction |
Current hairstyle set
Every category is deliberately capped at seven options to keep the decision surface focused and readable
Asset provenance is stored in public/references/PROVENANCE.md
REQUEST COMPILATION
OBJECTIVE BUILDER
The browser converts the form into one plain language production objective containing the following information
- Name and niche
- Build heritage age presentation hairstyle and eye color
- User supplied identity brief
- Archetype tone and language
- Values restrictions and disclosure requirements
- Requested first production
- A consistency requirement across every image and video
Create a coherent virtual influencer called NAME for NICHE — APPEARANCE — IDENTITY BRIEF — VOICE — BOUNDARIES — FIRST PRODUCTION — maintain the same recognizable identity across every image and videoTerminal full stops are removed from user facing copy but internal API syntax URLs selectors and technical values retain their required characters
NETWORK LAYER
IMD INTEGRATION
IMD exposes a public control plane at https://api.imd.fun and an Explorer at https://explorer.imd.fun
Personality.md uses public job reads request checking quote creation paid admission and read only workflow status polling
| PERSONALITY ROUTE | IMD DESTINATION | USE |
|---|---|---|
| GET /api/imd/jobs | GET /jobs | Read real public work |
| POST /api/imd/check | POST /requests/check | Run free planning and blocker validation |
| POST /api/imd/quote | POST /requests/quote | Save a real priced unpaid order |
| GET /api/imd/orders/:id | GET /requests/:id | Recover a quote payment or admission state |
| POST /api/imd/orders/:id/submit | POST /requests/:id/submit | Request or submit the explicit x402 payment |
| GET /api/imd/workflows/:id | GET /workflows/:id | Track the admitted contracts deployment frontend publishing and validation workflow |
Media skills used by the request builder
create-imagefor character portraits and image packscreate-videofor vertical introduction videos- A chain combines image creation followed by video creation for the default output
Personality.md is not an official IMD product and does not claim control over IMD workers pricing availability results or policy
OPEN OFFICIAL IMD API DOCS ↗FREE PRECHECK
VALIDATION
VALIDATE WITH LIVE IMD sends the composed request to the live IMD planner without payment
The response can contain a proposed plan facts blockers and suggestions
The request is being checked by the upstream planner
The plan contains no blockers and quote creation can be enabled
The request failed transport validation or returned one or more blockers
A form edit makes the earlier validation stale and quote creation is disabled
A successful check does not mean a job exists and does not guarantee that future paid work will complete successfully
REAL PAID ADMISSION
QUOTES AND PAYMENT
CREATE IMD QUOTE generates a fresh UUID request key and sends the validated action and input to IMD
The returned order is real but remains unpaid until the user reviews the exact live price network asset recipient and expiry
Authentication
The browser generates a random 32 byte token encoded as 64 hexadecimal characters and stores it in session storage The same-origin bridge forwards it as a Bearer credential and uses the same token to recover order status
Wallet sequence
- Connect an injected Ethereum wallet after an explicit click
- Switch to Ethereum Mainnet when required
- Read the wallet allowance granted to the official Permit2 contract
- Request a reusable IMD token approval only when the allowance is insufficient
- Request the x402 v2 challenge for the saved order
- Sign the Permit2 payment authorization
- Sign the EIP-712 QuoteApproval binding the exact payment payload to the exact IMD quote
- Submit both signatures through the same origin bridge
- Poll the saved order until it is admitted failed or expired
Personality.md never pays on page load Quote creation does not charge anything and every token approval payment signature and quote signature requires a visible wallet confirmation
The current job price is read from each IMD quote rather than hard coded The interface displays the token amount Ethereum Mainnet asset recipient order ID and expiry before enabling payment
A successful payment purchases admission to IMD It does not guarantee that the generated work will complete or satisfy every creative expectation
HIGGSFIELD REFERENCES
IMAGE + MOTION UPLOADS
The HIGGSFIELD workspace accepts one JPEG JPG PNG WEBP or GIF identity image up to 15 MB and one MP4 motion reference up to 50 MB and five seconds
The browser previews local files only after selection The server validates file type size and MP4 duration before issuing restricted direct upload tickets
The Higgsfield credential remains server side and is never returned to the browser committed to the repository or written into public Vite variables
The independent SWARM Creator still has no generic IMD attachment route Its original Build Hairstyle and Heritage selectors continue to send text values in the IMD objective
The result cards remain hidden until Higgsfield returns a real HTTPS video URL and the fairlaunch remains locked until that result exists
EXPLICIT CONSENT
WALLET
The site does not request accounts during initial page load
CONNECT calls eth_requestAccounts only after the user presses the button
After connection the header displays a shortened public address
The wallet can be asked to switch to Ethereum Mainnet and can display a separate Permit2 approval transaction when the IMD allowance is insufficient
The paid flow then requests one x402 Permit2 payment signature and one EIP-712 quote approval signature from the same wallet
No private key or seed phrase is requested stored transmitted or exposed by Personality.md
If no injected wallet exists the UI reports that no browser wallet was detected
WORK LIFECYCLE
JOBS AND RESULTS
An IMD quote is not a job A job exists only after the separate payment and admission flow succeeds
Public IMD job records can expose state objective template timestamps delivery information accepted submissions and result files depending on job progress
Current Personality.md coverage
- Read public job summaries
- Filter media and active work
- Validate a new job body
- Create a real unpaid quote
- Review the exact live IMD payment terms
- Check and request Permit2 approval
- Sign and submit a real x402 payment
- Poll payment and admission state
- Map successful admission to the real job status URL
- Track the native fairlaunch workflow through contracts deployment frontend publishing validation and completion
- Display repository launch and IPFS website outputs only when returned by IMD
Future coverage required
- Render additional accepted files and reports from general SWARM jobs
- Expose token and pool contract addresses when the workflow API returns them as structured fields
- Continue an existing personality project
PERSONALITY INDEX
MEDIA EXAMPLES
The standalone Personality Index lives at /personalities.html and contains four user supplied vertical videos packaged under public/videos
- Videos use a 9 by 16 display container
- Playback starts on pointer hover or keyboard focus
- Playback is muted looped and inline
- Leaving the card pauses the video and resets it to the beginning
- Each video has a pre-generated poster frame
The cards are examples of possible virtual influencer media and are not presented as outputs created through the current Personality.md request flow
OPERATING MODEL
AGENT RESPONSIBILITIES
| ROLE | RESPONSIBILITY | CURRENT PRODUCT STATE |
|---|---|---|
| Identity Architect | Biography values voice boundaries and long term goals | Represented in the brief |
| Visual Director | Face wardrobe environments framing and visual consistency | Represented in appearance fields |
| Content Room | Scripts posts story arcs and channel plans | Future workflow |
| Policy Guard | Disclosure permission impersonation and budget checks | Represented in boundaries |
| Growth Analyst | Performance evidence and recommendations | Future workflow |
| Publisher | Channel specific scheduling and distribution | Not implemented |
These roles describe the product architecture and intended orchestration They are not a claim that every named agent is currently running for every request
RESPONSIBLE CREATION
SAFETY AND IDENTITY RULES
- Do not impersonate a real person without documented authorization
- Do not present generated media as authentic footage
- Disclose AI generated identity and media where audiences could be misled
- Do not upload private credentials identity documents or confidential client material
- Define forbidden topics claims and behaviors before production
- Review every output before social publication
- Respect publicity copyright trademark and platform rules
- Do not assume ownership of third party visual references
The original selector images are design references rather than permission to reproduce a real person
CURRENT DATA MODEL
DATA AND PRIVACY
| DATA | LOCATION | LIFETIME |
|---|---|---|
| Form fields | Browser memory | Until refresh or navigation |
| Reference files | Browser file objects | Until removed or page closed |
| Reference previews | Temporary object URLs | Revoked after image load |
| IMD request token | Session storage | Current tab session |
| Public jobs | Fetched from IMD | Current page memory |
| Created quote | IMD control plane | Defined by IMD order policy |
Personality.md currently has no user account database analytics pipeline cloud file storage or personality library
The source contains no wallet private keys provider API keys or payment secrets
INTERACTION QUALITY
ACCESSIBILITY AND RESPONSIVE DESIGN
- Semantic labels connect controls to their names
- Visual option cards use real radio inputs
- Videos can play through pointer hover or keyboard focus
- Selected cards expose checked state to assistive technology
- Status areas use live regions for validation feedback
- Reduced motion preferences minimize animations and transitions
- Desktop grids collapse to readable mobile columns
- The Creator header and controls fit a true 390 pixel CSS viewport without horizontal overflow
SERVER BRIDGE CONTRACT
SERVER API
GET /api/imd/jobs
GET /api/imd/jobs?limit=60&exclude=oracleForwards a bounded public job request to IMD with a configured maximum limit of 100
POST /api/imd/check
{ "action": "job.open", "input": { "objective": "...", "skill": "create-video", "outputs": [] } }Forwards the proposed body to the free IMD request checker
POST /api/imd/quote
{ "action": "job.open", "input": { ... }, "requestKey": "UUID" }Requires x-personality-request-token containing exactly 64 hexadecimal characters The bridge forwards it as an Authorization Bearer token
POST /api/imd/orders/:id/submit
Without a payment header this route returns the live x402 challenge With PAYMENT-SIGNATURE and a quoteSignature body it forwards the signed payment and admission request to IMD
GET /api/imd/orders/:id
Reads the private saved order using the same client token and returns quoted payment pending admission pending admitted payment failed or expired state
GET /api/imd/capabilities
Reads enabled actions live prices network asset recipient limits and payment protocol configuration from IMD
Higgsfield server bridge
GET /api/higgsfield/configreturns public provider holder threshold chain and model configuration without exposing credentialsPOST /api/higgsfield/challengecreates the short-lived read-only wallet ownership messagePOST /api/higgsfield/verifyverifies the signature and live PMD balance on Ethereum MainnetPOST /api/higgsfield/upload-ticketvalidates file metadata and issues a restricted direct upload ticketPOST /api/higgsfield/generate-motionverifies both upload receipts validates the MP4 duration and starts Genjutsu Motion TransferGET /api/higgsfield/statusreads the authorized generation job until a real provider result is available
The Higgsfield credential remains server side Every challenge session upload receipt and job lookup is short lived and bound to the verified wallet
Bridge failure behavior
- Unknown bridge routes return 404
- Invalid request tokens return 401
- Upstream transport failures return 502
- Upstream status and JSON bodies are preserved where possible
- Responses use no store cache headers
LOCAL WORKFLOW
DEVELOPMENT
npm installnpm run dev -- --port 4178npm run checknpm run buildLocal routes
http://127.0.0.1:4178/landing pagehttp://127.0.0.1:4178/explorer.htmllive IMD jobs Explorerhttp://127.0.0.1:4178/personalities.htmlPersonality Indexhttp://127.0.0.1:4178/create.htmlCreator Studiohttp://127.0.0.1:4178/docs.htmlcomplete documentation
The production build is multi page and must emit index.html create.html and docs.html
PROJECT MAP
IMPORTANT FILES
| index.html | Landing agent swarm protocol and public product sections |
| explorer.html | Standalone live IMD jobs Explorer |
| personalities.html | Standalone Personality Index and vertical media examples |
| create.html | Standalone influencer Creator Studio |
| docs.html | Complete product and integration documentation |
| src/main.js | Decorative terminal wallet connection and homepage interactions |
| src/explorer.js | Live IMD jobs reads filters refresh and safe rendering |
| src/personalities.js | Vertical video cards hover playback focus playback and reset |
| src/create.js | Higgsfield holder generation native fairlaunch validation quote wallet Permit2 x402 submit and workflow polling |
| src/imd-launch.js | Constrained Ethereum fairlaunch payload pool validation and full quoted input verification |
| src/imd-payment.js | Canonical payment hashing quote approval types amount formatting and status labels |
| server/imd-paid-routes.js | Fail closed paid route mapping token validation and IMD request construction |
| server/imd-fairlaunch.js | Server side workflow.open chain permission step pool and motion reference validation |
| server/higgsfield-handler.js | PMD gate signed capabilities upload tickets motion transfer and MP4 validation |
| src/styles.css | Landing Explorer responsive system and media cards |
| src/create.css | Black Creator Studio visual system |
| src/docs.css | Documentation layout navigation tables and mobile rules |
| vite.config.js | Multi page build and development API bridge |
| scripts/check.mjs | Required asset behavior and route assertions |
| public/references | 21 original visual selector images plus provenance |
| public/videos | Four vertical examples poster images and provenance |
| public/imd-assets | Industrial scene assets and provenance warning |
HONEST BOUNDARIES
CURRENT LIMITATIONS
Image and motion generation requires a signed wallet proof and at least 100000 PMD on Ethereum Mainnet
The native workflow currently exposes ETH because the complete IMD validation passed for that pairing
Orders and active workflows recover within the browser session but no long term account database exists
Personality.md only declares token pool and website live when IMD reports a completed workflow live launch repository and website URL
No account creation scheduling posting or platform credentials exist
The intended long term identity memory is not stored by the current frontend
Vercel Functions expose the restricted same-origin API handlers used by the deployed application
IMD derived industrial assets require permission review before commercial publication
COMMON QUESTIONS
FAQ
IS PERSONALITY.MD AN OFFICIAL IMD PRODUCT
No It is an independent application concept using IMD public data and request APIs
DOES VALIDATION COST MONEY
No The current check route is used before quote creation and does not perform payment
DOES CREATE IMD QUOTE START A JOB
No It saves a real unpaid order The user must then review the terms approve Permit2 when required sign the payment and sign the quote approval
WHEN DOES IMD CHARGE THE WALLET
Only after the user presses the payment control and confirms the required wallet prompts Quote creation and validation do not charge
CAN I UPLOAD REFERENCE IMAGES
Yes in the HIGGSFIELD workspace after holder verification The independent SWARM request builder still has no generic IMD attachment route
DOES HIGGSFIELD AUTOMATICALLY LAUNCH A TOKEN
No Generation and fairlaunch are separate A real result unlocks the native SWARM form but CHECK quote payment and wallet confirmation remain explicit steps
DOES CHECK COST MONEY
No CHECK calls the live IMD planner without approval signature or payment
ARE THE SELECTOR IMAGES FROM HIGGSFIELD
No All 21 selector images are original assets generated for Personality.md
CAN THE SITE PUBLISH TO SOCIAL NETWORKS
No Social operation is part of the planned product model but is not implemented
DOES CONNECT SPEND FUNDS
No CONNECT requests account access only Spending requires the later Permit2 approval and payment confirmations
WHY DOES THE TERMINAL SAY WRONG COMMAND
The terminal is a decorative explanation surface Influencer creation belongs in the Creator Studio
CAN THIS BE DEPLOYED AS A STATIC SITE
The pages build statically while Vercel Functions provide the restricted same origin Higgsfield and IMD production bridges