Typed Core
Strict, TypeScript-first typings and type guards across the whole surface — the public API is generated from source so it never drifts.
Build Lavalink v4 bots with a stylish, strict and extendable API
Official documentation for Hoshimi — a typed Lavalink v4 client that's easy to use and always up to date. Built with strict typing, clean architecture and extensibility in mind, then documented down to nodes, players, filters, queues, storage and structures.
Runs onNode.js 22+Bun 1.3+Deno 2.5+
Node Management
Automatic node handling with session resumption, so players survive restarts and reconnects without losing state.
Built-in Autoplay
Keep the queue flowing with native autoplay for YouTube and Spotify — no extra plugins required.
Live Lyrics
First-class lyrics control with live, time-synced updates you can surface straight to your listeners.
REST + WebSocket
Dual transport with fully typed helpers and a granular, debug-friendly event system for total control.
Extensible by Design
Override nodes, players, queues and storage with your own structures — safety and validation come first.
Trusted byStelleMiyuGoTTY