{"id":28977034,"url":"https://github.com/kahlilashanti/mantis-ai-integration","last_synced_at":"2026-05-16T08:33:40.918Z","repository":{"id":300291273,"uuid":"1005795958","full_name":"kahlilashanti/mantis-ai-integration","owner":"kahlilashanti","description":"git commit -m \"Steps 4–6: Add iframe JS stub, example prompt, and system overview docs for Mantis AI agent integration\"","archived":false,"fork":false,"pushed_at":"2025-06-20T21:36:59.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-20T22:20:51.930Z","etag":null,"topics":["3d-commerce","ai-agents","ecommerce","ecommerce-store","langchain","mantis","openai-functions"],"latest_commit_sha":null,"homepage":"https://mantisxr.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kahlilashanti.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-20T20:47:49.000Z","updated_at":"2025-06-20T21:39:50.000Z","dependencies_parsed_at":"2025-06-20T22:21:04.218Z","dependency_job_id":"d7fce505-219c-4aa6-b2c9-da4095f55b8c","html_url":"https://github.com/kahlilashanti/mantis-ai-integration","commit_stats":null,"previous_names":["kahlilashanti/mantis-ai-integration"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kahlilashanti/mantis-ai-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kahlilashanti%2Fmantis-ai-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kahlilashanti%2Fmantis-ai-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kahlilashanti%2Fmantis-ai-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kahlilashanti%2Fmantis-ai-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kahlilashanti","download_url":"https://codeload.github.com/kahlilashanti/mantis-ai-integration/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kahlilashanti%2Fmantis-ai-integration/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270191644,"owners_count":24542278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-commerce","ai-agents","ecommerce","ecommerce-store","langchain","mantis","openai-functions"],"created_at":"2025-06-24T15:00:40.099Z","updated_at":"2026-05-16T08:33:35.872Z","avatar_url":"https://github.com/kahlilashanti.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mantis AI Integration Kit\n\nMantis makes 3D commerce simple—no Blender, no plugins, no dev time.  \nThis repo makes Mantis **AI-callable** from tools like LangChain, GPT-4o, Cursor, and v0.dev.\n\n\u003e \"Build a 3D storefront with Mantis\" — now works from a prompt.\n\n---\n\n## 🧠 What This Repo Is\n\nThis is the official SDK for integrating Mantis with AI agents. It includes:\n\n- ✅ LangChain tool definitions (`mantis_tools.py`)\n- ✅ A working LangChain agent demo (`mantis_agent_demo.py`)\n- ✅ OpenAI Function schema (`openai_functions_schema.json`)\n- ✅ JS postMessage stubs for iframe control (`postmessage_iframe_stub.js`)\n- ✅ Example prompts, use cases, and setup docs\n\n---\n\n## 🏁 Quickstart\n\n### 1. Clone this repo and install dependencies:\n\n```bash\ngit clone https://github.com/mantisxr/mantis-ai-integration.git\ncd mantis-ai-integration\npip install -r requirements.txt\n\nCreate a .env file with your OpenAI key based on .env.example\n\n2. Run the LangChain agent demo\npython mantis_agent_demo.py\nThe agent will simulate a natural-language request to load a 3D experience and update its content.\n\n🧱 Available Tools (MCP Spec)\nTool\tDescription\nload_experience\tLoad a Mantis storefront by URL\ngo_to_scene\tNavigate to a specific scene\nupdate_scene\tDynamically update scene content (logo, video)\nget_current_scene\tReturn the active scene ID\n\n🔗 OpenAI Function Calling\nYou can also plug openai_functions_schema.json directly into:\n\nGPT-4o agents\n\nv0.dev workflows\n\nOpenAI Assistant APIs\n\n🧪 Examples\nSee /examples/sneaker_store_prompt.md for natural-language use cases like:\n\n“Load the Cubs 3D store and swap the sponsor logo to Adidas.”\n\n📚 Docs\nSee /docs/how-it-works.md for a step-by-step breakdown of how the agent and tools work together.\n\n👀 What’s Coming\nFull CMS API integration\n\nLive iframe demo + hosted preview\n\nShopify/Roblox/Amazon-specific agent starters\n\n🔒 License\nMIT. Use, remix, and build with it.\n\n💬 Questions?\nVisit mantisxr.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkahlilashanti%2Fmantis-ai-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkahlilashanti%2Fmantis-ai-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkahlilashanti%2Fmantis-ai-integration/lists"}