Local hosting

Overview

Local hosting runs your assistant directly on your Mac. This is the default experience and the fastest path to get started, with no cloud account setup required.

When to use local

You are developing and iterating quickly.
You want direct access to local files and tools.
You prefer keeping runtime data on your own machine.

If you need stronger runtime isolation or cloud uptime guarantees, continue to Advanced options.

How to run

Local mode is the default when creating an assistant:

vellum hatch

Runtime logs and diagnostics stay on your machine. This improves observability and debugging speed during development.

Tradeoffs

Strengths: Fast setup, low latency, and direct local tool/file access.
Limitations: Availability depends on your Mac being online and able to provide compute resources.