MeshVault

A professional, local web-based tool for rapidly browsing, previewing, and managing 3D assets across your filesystem — including assets inside archives.

Supported Formats

3D Models	Archives
`.obj`, `.fbx`, `.gltf`, `.glb`, `.stl`, `.ply`, `.dae`, `.3mf`, `.usdz`	`.zip`, `.rar`, `.unitypackage`

Older FBX files (version < 7000) are auto-converted to OBJ by a built-in zero-dependency parser. .usdz is import-only.

Features

Category	Features
Browsing	Sidebar tree, list/grid view with rendered thumbnails, sort, filter, remember last directory
Library	Cross-folder search, tags & collections, recent files (all backed by a local index)
File Management	Right-click: rename (inline), duplicate, delete, show in file manager
3D Viewer	PBR rendering, SSAO, soft shadows, ACES tone mapping, orbit + FPV drone navigation
Toolbar	Screenshot, grid, axes (XYZ), wireframe, normals viz, texture folder picker, material inspector, lights, measure
Animation	Play/pause, scrub, speed, clip selector for animated GLB/FBX/Collada
Transforms	Reload, reset, center, ground, auto-orient (PCA), rotate ±90° per axis
Mesh Ops	Simplify (edge collapse LOD, UV-preserving), recompute smooth normals (UV-preserving)
Textures	Folder picker with smart matching (convention + fuzzy name) for separated texture packs
Export	Save As dialog, folder browser, modified models export as OBJ/GLB with baked transforms
Extras	Drag-and-drop load, measurement, 12 background presets, scale, persistent settings
AI agents	Self-describing JSON control API (`/llms.txt`), `describe_scene` text snapshots, and an MCP server (`meshvault-mcp`) for Claude/Cursor — see docs/mcp.md
Security	Loopback bind, session-token auth, path confinement to an allowed root (see below)

Quick Start

git clone https://github.com/lpalbou/meshvault.git
cd meshvault
poetry install --no-root
poetry run meshvault

Open http://localhost:8420 · Also: pip install meshvault or npx meshvault

MeshVault binds to 127.0.0.1 and requires a session token on every /api/* request. By default it can browse your whole filesystem (opening at your home directory) — the network protections (loopback + token + Host allow-list) are what keep it private. Set MESHVAULT_ROOT=/path[:/path2] to restrict file access to specific directories. Configure MESHVAULT_HOST (bind host) and MESHVAULT_TOKEN as needed. Opening the URL on the same machine authenticates automatically; other devices need the token from the launch banner. See API Reference.

Control MeshVault with AI agents

MeshVault is built to be driven by agents, not just humans. Three entry points, from lightest to most integrated:

Self-describing JSON control API — the viewer exposes one entry point, execute({action, params}), with ~48 discoverable commands (listCommands()), plus describe_scene: a structured text snapshot (inventory, size, materials, geometry-QA issues, current view) so a text-only agent can reason without screenshots. Agent-ready reference served at /llms.txt and /llms-full.txt.
MCP server — meshvault-mcp lets Claude Desktop / Claude Code / Cursor drive a headless viewer natively through 6 tools: load a model by URL or local file path, describe it, run any viewer command, and get PNG screenshots back as image content (best_view: true gives a one-call hero shot). Setup: docs/mcp.md.
Embeddable standalone viewer — meshvault-viewer.js is a server-less ES-module bundle (Three.js included, offline, compressed-glTF decoders bundled) exposing the same control API for your own pages or agent harnesses.

Typical agent flow: load → describe_scene → find_best_view (finds the model's semantic front and uprights it) → set_render_mode / set_clip to inspect → screenshot.

Documentation

Getting Started — Installation, UI overview, complete feature guide
Architecture — System design, components, rendering pipeline
API Reference — REST API (14 endpoints)
MCP Server — Drive the viewer from Claude/Cursor via Model Context Protocol
FAQ — Troubleshooting and tips

License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meshvault-0.3.1.tar.gz (1.3 MB view details)

Uploaded Jul 6, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

meshvault-0.3.1-py3-none-any.whl (1.3 MB view details)

Uploaded Jul 6, 2026 Python 3

File details

Details for the file meshvault-0.3.1.tar.gz.

File metadata

Download URL: meshvault-0.3.1.tar.gz
Upload date: Jul 6, 2026
Size: 1.3 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for meshvault-0.3.1.tar.gz
Algorithm	Hash digest
SHA256	`abc54e6c0057f29c0a6454c029c7ddf9d9087d6c87605d10d0ac1f904a290b48`
MD5	`a567b4bce38c9eaedc0349187603206e`
BLAKE2b-256	`b0fb538edd28d3fe7e968350d0e9cd2c6f24dae502a6284b32a97e1acd2343af`

See more details on using hashes here.

Provenance

The following attestation bundles were made for meshvault-0.3.1.tar.gz:

Publisher: release.yml on lpalbou/MeshVault

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: meshvault-0.3.1.tar.gz
- Subject digest: abc54e6c0057f29c0a6454c029c7ddf9d9087d6c87605d10d0ac1f904a290b48
- Sigstore transparency entry: 2090826182
- Sigstore integration time: Jul 6, 2026
Source repository:
- Permalink: lpalbou/MeshVault@3949fe59f9254e80e01603875b408f60e9c3a510
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/lpalbou
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@3949fe59f9254e80e01603875b408f60e9c3a510
- Trigger Event: push