Skip to content

Getting started (from source)

This is the build-it-yourself path. It runs Voyalier in your browser on macOS or Linux development hosts supported by both Node.js 24 and the current stable Rust toolchain. That includes supported Linux distributions and Intel Macs that meet those tool requirements, as well as anyone who would rather read the source than trust a binary.

If you just want the app, download it for Apple Silicon macOS or Windows instead.

Requirements are Bash, Make, Node.js 24+, pnpm 11+, and the stable Rust toolchain. Node.js 24 requires macOS 13.5 or newer; check the official Node.js 24 platform list and Rust platform support before choosing this route.

Terminal window
git clone https://github.com/udhawan97/Voyalier.git
cd Voyalier
make bootstrap
make dev

The React interface runs at 127.0.0.1:5173, with the local Axum API at 127.0.0.1:8787. The desktop build uses direct Tauri IPC instead of this development server path.

Open a trip to try it out: import a confirmation (paste, a local file, HTML, or a raw email), fetch official advice and a weather outlook, save and map a recommended place, save a web link as a research resource to read later, build a packing checklist with visible progress, add a manual activity or transfer, search the workspace, download offline city data, and print or copy a redacted brief. AI is optional — every non-AI feature above works without it. For on-device assist, a guided setup under AI providers walks you through installing Ollama, starting it, and pulling a recommended model in-app (no terminal required, though a copyable ollama pull command is offered too); for cloud assist, paste an OpenAI or Anthropic key and choose Validate & save, and it is checked before being stored in your OS keychain. Every AI request that could leave your device shows a full preview before anything is sent; the local chat has no preview because it never leaves.

Run make check before submitting changes.

The Guides cover each workflow in depth: trips and the Blueprint, importing confirmations, research resources, readiness and official advice, offline packs, recommendations, and maps, AI assist, and the encrypted vault.