> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highailabs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AI Worlds
> Every research report becomes a navigable 3D world — terpene profiles and High Families mapped to immersive environments via World Labs.
**Status:** Archived concept — not current product or implementation guidance
**Phase:** Phase 5 (AI Media) | **Tier:** Studio
This page preserves early product exploration only. It does not authorize
automatic generation, unlimited usage, a provider, a model, public storage,
or customer-data processing. Current notebook companion execution is off;
see [Notebook Media Governance](/guides/platform/notebook-media-governance).
## Overview
You upload a dispensary receipt. High IQ generates a research report analyzing your three strains. Then it generates something no one expects: a 3D world you can walk through. A bioluminescent forest floor because your order was Myrcene-heavy. A mountaintop zen garden because your dominant High Family was Focused Highs. Floating amber orbs representing your Caryophyllene content. You navigate this world on your phone — panning, zooming, exploring an environment that exists because of and only because of the specific cannabis you purchased.
AI Worlds is the most experimental feature on the AI media roadmap. It takes the terpene-to-sensory mapping that underlies Strain Art and Session Music and expresses it in a third dimension. Where art is static and music is temporal, a world is spatial. You move through it. You discover things. The environment itself is the data visualization — lush and dense when your terpenes are rich, sparse and minimal when your profile is focused, chaotic and colorful when your strains are diverse.
The technology enabling this is World Labs' Marble multimodal world model, which generates navigable 3D scenes from text prompts and optional reference images. The scenes are rendered in the browser (or a WebView on mobile), so no app download or special hardware is required. The worlds are persistent — once generated, they live at a URL you can share, revisit, and explore.
This is the "future demo" feature. The one that makes people say "wait, what?" when they see it. It is not the most practical AI media format — podcasts and social posts deliver more immediate daily value. But it is the most memorable, the most shareable as a novelty, and the strongest signal that High IQ is building something genuinely different from every other cannabis app on the market.
## What It Does
### World Generation
When a research report finishes generating, the system extracts the structured context: all strain names, their terpene profiles (with percentages), High Family classifications, dominant effects, and the overall "vibe" of the order.
The terpene-to-environment mapping engine translates the chemical data into environmental concepts. Each terpene maps to terrain, lighting, atmosphere, and objects. The High Family sets the overall theme. The combination of strains in the order determines the world's complexity and diversity.
A detailed prompt is assembled describing the 3D scene: "A tranquil lakeside at twilight with bioluminescent moss covering the shore. Dense forest rises in the background with warm amber light filtering through the canopy. A single stone path leads to a clearing where soft purple orbs float. The atmosphere is misty and warm. The mood is deeply calming with an undercurrent of wonder."
The prompt (and optionally a reference image derived from the user's Strain Art) is sent to the World Labs API. The API generates a navigable 3D scene and returns a world URL, preview image, and metadata.
The world appears on the research report screen as an "Explore World" button with a preview image thumbnail. Tapping it opens a full-screen WebView (mobile) or a new browser tab (web) with the navigable 3D scene. The world URL is shareable.
### Terpene-to-Environment Mapping
| Terpene | Terrain | Lighting | Atmosphere | Objects |
| ----------------- | --------------------------------------------------------------- | ------------------------------------------------ | ---------------------------- | ------------------------------------------------------- |
| **Myrcene** | Dense forest floors, mossy terrain, river valleys | Warm amber, filtered through canopy, golden hour | Misty, humid, enveloping | Ancient trees, moss-covered stones, flowing water |
| **Limonene** | Bright sunlit clearings, open meadows, coastal cliffs | Direct sunlight, golden and warm, high contrast | Clear, crisp, warm | Wildflowers, citrus trees, sun-warmed rocks |
| **Caryophyllene** | Warm desert scenes, canyon terrain, sandstone formations | Amber-orange sunset, deep warm shadows | Dry, spiced, windswept | Weathered rock, desert plants, ember particles |
| **Pinene** | Mountain landscapes, evergreen forests, alpine lakes | Cool morning light, blue-white, high altitude | Thin, crystalline, fresh | Pine trees, mountain peaks, snow patches |
| **Linalool** | Garden settings, terraced fields, moonlit meadows | Soft diffused light, lavender-tinted, ethereal | Soft focus, gentle, peaceful | Flowering bushes, stone fountains, fireflies |
| **Terpinolene** | Abstract impossible geometry, floating islands, prismatic caves | Shifting iridescent, rainbow refractions | Dreamlike, slightly surreal | Crystalline structures, impossible architecture, prisms |
| **Humulene** | Underground caverns, ancient ruins, volcanic terrain | Dim amber glow, firelight, bioluminescence | Heavy, mineral, ancient | Stalactites, carved stone, glowing minerals |
| **Ocimene** | Tropical settings, jungle canopy, coral reefs | Dappled tropical light, vibrant greens | Lush, humid, alive | Exotic flowers, tropical birds, waterfalls |
### High Family Theme Mapping
The High Family sets the world's overall narrative and compositional theme:
| High Family | World Theme | Mood |
| ------------------- | -------------------------------------------- | ------------------------------------------ |
| **Blissful Highs** | Tranquil lakeside, bioluminescent night | Profound peace with hidden wonder |
| **Creative Highs** | Abstract art studio, vibrant floating shapes | Playful chaos with meaningful patterns |
| **Energetic Highs** | Festival space, golden hour rooftop | Electric excitement with warm community |
| **Focused Highs** | Zen garden, minimalist architecture | Precision with beauty in simplicity |
| **Relaxed Highs** | Hot springs, cloud terrain, hammock grove | Total comfort without boredom |
| **Balanced Highs** | Mountain summit, sunrise vista | Clarity with perspective in all directions |
### Combining Terpenes and High Family
When a report contains multiple strains, the world reflects the blend. An order with one Myrcene-heavy indica (Relaxed Highs) and one Limonene-dominant sativa (Energetic Highs) produces a world that transitions — you start in a misty forest and walk along a path that opens into a sunlit clearing. The journey through the world mirrors the potential journey through consuming those strains in sequence.
## User Value
AI Worlds is the format that generates the strongest "wait, your app does WHAT?" reaction. It is the demo feature — the one a user shows friends not because it is useful, but because it is unbelievable. That reaction converts onlookers into downloaders more effectively than any practical feature demonstration.
## Technical Approach
### Architecture
| Layer | Technology | Notes |
| ----------------------- | ------------------------------- | ------------------------------------------------------- |
| **Context Extraction** | Existing report data | Terpene profiles, High Family, strain metadata |
| **Environment Mapping** | Custom mapping engine | Terpenes + High Family to environmental description |
| **Prompt Construction** | LLM-assisted | Compose vivid scene descriptions from mapping output |
| **World Generation** | World Labs API (Marble) | Generates navigable 3D scene from text + optional image |
| **Preview Image** | World Labs API | Returns a static preview frame for thumbnails |
| **World Viewer** | WebView (mobile) / iframe (web) | Renders the 3D scene with touch/mouse navigation |
| **Storage** | Supabase | Stores world metadata, URLs, generation parameters |
### Database Schema
```
ai_worlds
├── id (uuid, PK)
├── user_id (text, FK)
├── report_id (uuid, FK)
├── world_labs_id (text, unique)
├── status (enum: pending, generating, ready, failed, expired)
├── prompt (text)
├── reference_image_url (text, nullable)
├── world_url (text, nullable)
├── preview_image_url (text, nullable)
├── metadata (jsonb)
│ ├── terpene_mapping (object)
│ ├── high_family (string)
│ ├── strains (array)
│ ├── generation_time_ms (number)
│ └── model_version (string)
├── cost_credits (decimal)
├── created_at (timestamptz)
├── expires_at (timestamptz)
└── updated_at (timestamptz)
```
### Implementation Phases
Generate a static 2D "world preview" image using the existing Strain Art pipeline with environmental prompts instead of abstract art prompts. Display as a teaser on the report page. No navigation, no 3D. This validates the terpene-to-environment mapping and the user interest level.
Integrate the World Labs API. Generate actual navigable worlds from report data. Implement the WebView viewer. Measure generation time, cost, and quality.
Full mobile integration with "Explore World" button, loading states, WebView navigation, share functionality, and push notification when world is ready.
Optimize load times, add a guided tour mode (camera auto-navigates through the world with narration from the report), improve environment diversity, and add world-specific share cards.
Implement world persistence policies (keep for 90 days, re-generate on demand), explore caching for popular strain combinations, and optimize costs through batching.
### Key Technical Challenges
1. **Generation time** — 3D world generation is likely the slowest of all AI media formats (1-5+ minutes). The UX must make this feel acceptable: queue the generation, push notify when ready, show a preview image immediately.
2. **Mobile WebView performance** — 3D scenes in a WebView may be janky on older iPhones. Need to test extensively on iPhone 12/13 (minimum supported devices) and degrade gracefully (fall back to a panoramic image if 3D rendering is too slow).
3. **World Labs API maturity** — As of early 2026, the World Labs API is new. Pricing, rate limits, quality consistency, and uptime are unknown quantities. This feature depends heavily on a third-party API that may change significantly.
4. **Prompt consistency** — The same terpene profile should produce worlds that feel similar but not identical. A user who generates worlds for the same strain twice should get worlds that feel related (same biome, same mood) but not duplicated.
5. **Storage and expiration** — World Labs worlds may have hosting costs or expiration policies. Need to understand whether worlds persist indefinitely or expire, and plan accordingly.
## Tier Impact
| Tier | Access |
| ------ | ------------------------------------------------------------------------------------------------------ |
| Free | See the static preview image on the report page with a "Pro" badge. Cannot explore the 3D world. |
| Pro | Can view worlds generated by other features, but world generation is a Studio feature. |
| Studio | Full world generation for every report. Unlimited exploration. Shareable world URLs. Guided tour mode. |
AI Worlds is tentatively a Studio-tier feature due to the expected higher per-generation cost. If World Labs pricing comes in lower than expected, it could move to Pro tier.
## Dependencies
* [x] Research report pipeline — **built and live**
* [x] Strain terpene profiles — **built and live**
* [x] High Family classification — **built and live**
* [ ] World Labs API account and integration
* [ ] Terpene-to-environment mapping engine
* [ ] WebView integration for 3D world viewing
* [ ] Push notification for "world ready" event
* [ ] `ai_worlds` Supabase table and migration
* [ ] World preview image generation (Phase 1)
* [ ] Share functionality for world URLs
## Open Questions
1. **World Labs pricing** — The API is new and pricing structures are unclear. Per-generation costs could range from $0.50 to $5.00+. This single factor determines whether AI Worlds is viable at Pro tier or must be Studio-only.
2. **Generation time** — How long does a world take to generate? If it is under 2 minutes, we can show a loading screen. If it is 5+ minutes, we must use background generation with push notification. Need benchmarks.
3. **Mobile rendering performance** — Can a WebView-based 3D scene run smoothly on an iPhone 13? What about iPhone 12? Need device testing to determine minimum supported hardware.
4. **World persistence** — Do worlds generated by World Labs persist indefinitely, or do they expire? If they expire, we need to handle re-generation gracefully. If they persist, hosting costs may accumulate.
5. **Multi-strain worlds** — When a report has 3-5 strains, should the world represent the blend (one cohesive environment) or the individual strains (zones within the world that you travel between)? Zones are more interesting but more complex to prompt.
6. **Reference images** — Should we feed the user's Strain Art as a reference image to World Labs for visual consistency? This could make the world feel connected to other AI media outputs, creating a cohesive aesthetic across formats.
## Related Features
* [Video Reports](/planning/ai-media/video-reports) — Worlds could be recorded as flythrough videos for sharing
* [Strain Art](/planning/ai-media/strain-art) — Visual mapping system shared between art and worlds
* [Session Music](/planning/ai-media/session-music) — Worlds could play the session soundtrack during exploration
* [AI Music Videos](/planning/ai-media/ai-music-videos) — A world flythrough with session music is essentially a music video