Skip to content

trip-meta/TripMeta

Repository files navigation

TripMeta - AI-Powered VR Tourism Platform

Unity

[License [Platform [Status

An immersive VR tourism experience powered by AI

English简体中文

Live DemoReport IssueContribute


Quick Links

Resource Link
🌐 Live Demo trip-meta.github.io/TripMeta/site
📖 Documentation TripMeta/docs
📹 Source Code github.com/trip-meta/TripMeta
🎬 Demo Video Watch VR Demo
🐛 Issue Tracker GitHub Issues
💬 Discussions GitHub Discussions
📜 Changelog Releases

Demo Video

https://trip-meta.github.io/TripMeta/site/vr.mp4


Overview

TripMeta is an innovative VR tourism platform combining AI technology with virtual reality. It provides intelligent tour guides and immersive travel experiences where users can:

  • 🌍 Explore virtual attractions worldwide using PICO VR headsets
  • 🤖 Converse naturally with AI tour guides powered by GPT
  • 📚 Learn about history and culture through rich knowledge graphs
  • 🎯 Interact intuitively using voice dialogue and VR controllers

System Architecture

TripMeta System Architecture

Architecture Highlights:

Metric Target Status
Frame Rate 90 FPS ✅ PICO 4 Ready
Latency <20ms ✅ Motion-to-photon
AI Response <2s ✅ GPT-4 Optimized
Memory Budget <4GB ✅ Optimized

Key Features

🤖 AI Tour Guide

  • GPT-Powered Conversations: Natural language understanding and generation
  • Personalized Responses: Context-aware explanations based on user interests
  • Multi-language Support: English, Chinese, Japanese, and more
  • Rich Knowledge Base: Historical facts, cultural insights, and travel tips

🥽 Immersive VR Experience

  • PICO 4 Support: Optimized for PICO VR headsets
  • 90 FPS Performance: Smooth, comfortable VR experience
  • Low Latency: <20ms motion-to-photon latency
  • High-Quality Graphics: Universal Render Pipeline (URP)

🎯 Natural Interactions

  • Voice Commands: Speak naturally to interact with the AI guide
  • VR Controllers: Intuitive hand tracking and gesture recognition
  • Spatial UI: Floating interfaces positioned in 3D space
  • Haptic Feedback: Realistic touch sensations

Technology Stack

Component Technology Purpose
Game Engine Unity 2021.3.11f1 Core development platform
VR Platform PICO 4 Target VR headset
Render Pipeline Universal Render Pipeline (URP) High-performance graphics
Input System Unity Input System Modern input handling
AI Engine GPT-4 via OpenAI API Conversational AI
Speech Azure Cognitive Services Voice recognition & TTS
Vision Azure Computer Vision Object detection & AR
Networking Unity Netcode for GameObjects Multiplayer support

Project Structure

TripMeta/
├── Assets/
│   ├── Scripts/
│   │   ├── AI/              # AI Services (GPT, Speech, Vision)
│   │   ├── Core/            # Infrastructure (DI, Config, Errors)
│   │   ├── Features/        # Business Logic (Tour Guide, Social)
│   │   ├── Interaction/     # Input Handling (VR Controllers)
│   │   ├── Presentation/    # UI/UX Components
│   │   ├── VR/              # PICO Integration
│   │   └── Editor/          # Unity Editor Tools
│   ├── Scenes/              # Unity Scene Files
│   └── Packages/            # Unity Package Manager
├── docs/                    # Documentation
├── README.md                # English Documentation
└── README_CN.md             # Chinese Documentation

Quick Start

Prerequisites

Requirement Version/Platform
Unity 2021.3.11f1 or later
OS Windows 10/11
VR Headset PICO 4 (optional)
Git Latest version

Installation

# Clone the repository
git clone https://github.com/trip-meta/TripMeta.git
cd TripMeta

# Open in Unity Hub
# 1. Install Unity Hub from unity.com
# 2. Click "Add" → Select this folder
# 3. Open with Unity 2021.3.11f1

First Run Setup

Unity Editor Menu:
├── TripMeta
│   ├── Create Configuration Assets  ← Run this first (creates ScriptableObjects)
│   └── Setup Main Scene           ← Run this after config creation
  1. Create Configuration Assets

    • Go to TripMeta > Create Configuration Assets
    • Creates ScriptableObject configurations in Assets/Resources/Config/
    • Required before first run
  2. Setup Main Scene

    • Go to TripMeta > Setup Main Scene
    • Configures the main scene with required systems
    • Registers all services and initializes the application
  3. Press Play

    • The application will boot up and show the VR scene
    • Use VR headset or editor preview to explore

Documentation

Document Description
Quick Start Guide Detailed setup instructions
Architecture System design and patterns
AI Integration AI services setup
Tech Stack Complete technology overview
Development Standards Coding conventions
Testing Guide Testing strategies
Deployment Guide Build and deploy
Troubleshooting Common issues

Development Workflow

  1. Fork the repository
  2. Create a feature branch:
    git checkout -b feature/your-feature-name
  3. Commit your changes:
    git commit -m "feat: add some amazing feature"
  4. Push to your branch:
    git push origin feature/your-feature-name
  5. Open a Pull Request on GitHub

See CONTRIBUTING.md for detailed guidelines.

CI/CD

The project uses GitHub Actions for automated testing and building:

Workflow Purpose
Unity Build and Test Automated Unity builds and unit tests
Code Quality Check Static analysis and style checks
Performance Tests FPS and latency validation

Setup Instructions: See GitHub Actions Setup Guide

Performance Targets

Metric Target Notes
Frame Rate 90 FPS PICO 4 requirement
Latency <20ms Motion-to-photon
Memory <4GB Total budget
Draw Calls <100 Per frame optimization
Triangles <50K Per scene limit

Contributing

We welcome contributions! Please read our Contributing Guidelines.

Areas of Contribution:

  • 🐛 Bug fixes
  • ✨ New features
  • 📖 Documentation improvements
  • 🎨 UI/UX enhancements
  • ⚡ Performance optimizations
  • 🌍 Multi-language support

License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2025 TripMeta Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...

See LICENSE file for full text.

Acknowledgments

Built with amazing open-source technologies:

Roadmap

  • Initial release with AI tour guide
  • PICO 4 VR support
  • Multi-user VR sessions
  • AR attraction overlays
  • Real-time translation
  • Mobile app companion
  • Unity 2022.3 upgrade

About

基于Unity构建的AI驱动VR旅游平台。在PICO VR头显上探索虚拟景点,体验智能导游服务 - Trip2022Hackthon大赛决赛

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors