Vela
Vela is a local-first, voice-first assistant designed around a browser PWA, a gateway service, and self-hosted integrations for speech, LLM orchestration, home automation, search, and speech synthesis.
Documentation
- Project overview
- Architecture
- Event protocol and state machine
- Integrations and tool safety
- Deployment and operations
- Setup and workspace usage
- Phased backlog
- README migration map
Development
- Use mise for tooling in this repository.
- Use Yarn as the package manager once provisioned by mise.
- Bootstrap tools with
mise install. - Run repo commands with
mise exec -- yarn …if your shell is not activated for mise. - Install workspace dependencies with
mise exec -- yarn install. - Start the SvelteKit UI with
mise exec -- yarn dev:ui. - Start the Fastify gateway with
mise exec -- yarn dev:gateway. - Build the UI with
mise exec -- yarn build:uiand run the UI check withmise exec -- yarn check:ui.
Working Agreement
- AGENTS.md defines how implementation work and documentation should stay aligned.
Status
The repository now includes a minimal runnable SvelteKit UI and a minimal runnable Fastify gateway as the baseline for the next vertical slices.