AI Tour Guide Generator
Tạo tour 3D có thuyết minh AI.
Tải ảnh hoặc panorama, để LLM viết lời dẫn hướng dẫn viên, chỉnh sửa script và render giọng nữ bằng VieNeu-TTS cho từng điểm dừng trong tour.
Giới thiệu dự án
Dự án tập trung vào một luồng chính: sinh tour tham quan có giọng dẫn.
Công cụ này hỗ trợ tạo tour 3D từ bộ ảnh thực tế hoặc panorama. Người dùng quản lý nhiều dự án, sắp xếp lộ trình tham quan, chọn provider AI, sinh mô tả từng view và chuyển script thành audio.
Tính năng AI tạo building đã được rút khỏi trang giới thiệu để sản phẩm rõ trọng tâm hơn: AI tour guide, panorama viewer, thông tin nổi trên ảnh và giọng thuyết minh có thể tái sử dụng.
Cơ chế hoạt động
Từ ảnh đầu vào tới tour toàn màn hình có audio.
Bước 1
Tạo dự án và tải view
Người dùng tạo nhiều dự án tour, thêm ảnh thường, ảnh panorama hoặc nguồn ảnh online cho từng điểm dừng.
Bước 2
LLM đọc ảnh và viết nội dung
Backend gửi ảnh đến Gemini, Groq, OpenAI, Claude hoặc mock AI để sinh tiêu đề, mô tả và điểm nổi bật bằng tiếng Việt.
Bước 3
Biên tập lời dẫn
Hệ thống tạo script hướng dẫn viên gồm mở đầu, từng điểm dừng và phần kết; người dùng có thể chỉnh sửa trước khi lưu.
Bước 4
Render giọng nữ và phát tour
VieNeu-TTS tạo WAV, lưu lên Supabase Storage nếu đã cấu hình, rồi ghi lại cùng manifest để mở lại tour không phải render audio từ đầu.
Architecture sử dụng
Local-first frontend, FastAPI backend và AI provider có thể thay đổi.
Frontend
Next.js App Router, React state local-first, Tailwind CSS, viewer panorama bằng Three.js/R3F.
Backend/API
FastAPI nhận upload, đẩy media lên Storage, tải ảnh URL, gọi LLM runtime, tạo script tour và render audio.
AI Layer
Adapter cho Gemini, Groq, OpenAI, Claude và mock AI; model được chọn theo provider từ dropdown.
Audio & Storage
VieNeu-TTS sinh giọng nữ, ảnh/audio lưu Supabase Storage khi có cấu hình; project tour lưu Supabase hoặc localStorage fallback.
Architecture graph
Sơ đồ tổng thể các khối chính trong hệ thống AI tour, từ landing page đến player toàn màn hình.
Node 1
Landing page
Giới thiệu, audio guide, video demo slot
Node 2
Tour Builder
Project CRUD, upload ảnh, chọn provider/model
Node 3
FastAPI
Validate request, upload media, điều phối LLM/TTS
Node 4
Supabase
Postgres lưu project, Storage lưu ảnh và WAV
Node 5
AI Providers
Gemini, Groq, OpenAI, Claude hoặc mock AI
Node 6
VieNeu-TTS
Sinh WAV giọng nữ và cache theo script
Node 7
Tour Player
Panorama toàn màn hình, info overlay, audio segment
Runtime flow graph
Project state lưu trên trình duyệt để chạy local không cần database.
Audio WAV được cache theo nội dung script và voice để dùng lại.
Manifest tour giữ thứ tự segment, ảnh, mô tả và audio URL.
Demo landing flow
Khung gắn video demo và giọng đọc giới thiệu.
Video walkthrough minh họa flow tạo tour, upload ảnh, sinh lời dẫn, render audio và mở tour toàn màn hình. Audio dưới đây là lời dẫn giới thiệu website.
Mở video demo trên YouTubeBắt đầu từ một bộ ảnh tour.
Trọng tâm hiện tại của dự án là tạo, chỉnh sửa và phát AI tour có thuyết minh.