Monorepo для пакета Aholo Viewer и его сайта с документацией.

Что такое Aholo Viewer

Aholo Viewer — это высокопроизводительный рендерер для 3DGS и Mesh. Он использует схему Chunked Steaming Lod для работы с огромными 3DGS.

Использование

Следуйте инструкции.

Если всё пойдёт хорошо, ты увидишь это

Для использования пакетов в npm см. packages/renderer/README.md.

Для преобразования активов, ESZ chunk LOD и воксельных коллайдеров см. packages/splat-transform/README.md и руководство по splat-transform.

Для интеграции с помощью ИИ используйте docs/ai/skills/use-aholo-viewer/SKILL.md.

Требования к сборке

• Узел: >= 22.22.1
• PNPM (предпочтительно использовать corepack)

Клонируйте это хранилище

Этот репозиторий содержит некоторые подмодули в виде зависимости, используйте следующую команду для клонирования репозитория.

Структура

Приказы

Запустите команды рабочего пространства из корня репозитория:

Целевые корневые команды:

Проект Docs

• AGENTS.md: краткое руководство для агентов ИИ и будущих сессий по программированию
• docs/architecture.md: текущая структура рабочего пространства и поток зависимостей
• docs/ai/vibe-coding-guide.md: подробное руководство по будущим изменениям с помощью ИИ, стилю написания и передачам
• 'docs/ai/skills/use-aholo-viewer/SKILL.

Aholo Viewer

Monorepo for the Aholo Viewer package and its documentation website.

What is Aholo Viewer

Aholo Viewer is a high performance Renderer for 3DGS and Mesh. It uses Chunked Steaming Lod schema to handle huge 3DGS.

Usage

Follow the Manual.

If everything goes well you will see this

For npm package usage, see packages/renderer/README.md.

For asset conversion, ESZ chunk LOD, and voxel colliders, see packages/splat-transform/README.md and the splat-transform manual.

For AI-assisted integration, use docs/ai/skills/use-aholo-viewer/SKILL.md.

Build Requirements

• Node: >= 22.22.1
• pnpm(corepack preferred)

Clone this repository

This repository contains some submodules as dependencies, use following command to clone the repository.

git clone --recurse-submodules https://github.com/manycoretech/aholo-viewer.git

Structure

aholo-viewer/
  AGENTS.md             Agent-facing project guide
  website/              Astro website: home, manual, examples, API docs, playground
  packages/renderer/    Renderer TypeScript source package
  packages/splat-transform/  Processing CLI and Node subprocess API
  packages/splat-transform-native/  C++ engine and platform executables
  scripts/              Shared build and documentation scripts
  docs/                 Architecture and AI collaboration notes
  external/             Required upstream and workspace dependency sources
  .codex/skills/        Project-local Codex skills

Commands

Run workspace commands from the repository root:

pnpm install
pnpm dev
pnpm check
pnpm build
pnpm preview

Targeted root commands:

pnpm build:renderer
pnpm build:website
pnpm check:content
pnpm check:renderer
pnpm check:website
pnpm docs:api

Project Docs

• AGENTS.md: quick guide for AI agents and future coding sessions
• docs/architecture.md: current workspace structure and dependency flow
• docs/ai/vibe-coding-guide.md: detailed guide for future AI-assisted changes, writing style, and handoffs
• docs/ai/skills/use-aholo-viewer/SKILL.md: external npm package usage guide for AI coding agents