A high-performance Lavalink v4 wrapper for Python, inspired by WaveLink.
Documentation · Discord Server
- Full Lavalink v4+ REST API support
- Built on msgspec for rapid serialization and strict type validation
- Optional curl_cffi for faster networking
- Async-first and Basedpyright strict-compliant
- Multi-library native support for discord.py, py-cord, disnake, and nextcord
The full documentation is available at https://sonolink.readthedocs.io/en/latest. It includes guides on getting started, Lavalink setup and moving from other libraries, as well as a comprehensive API reference.
Examples may be found in the examples directory.
Note
A virtual environment is recommended, especially on Linux where the system Python may restrict package installations.
- Python 3.12 or higher
- A running Lavalink 4.x server (guide on setup)
- One of the following discord libraries with the
[voice]extra:- discord.py 2.7+
- py-cord 2.8+
- disnake 2.12+
- nextcord 3.1.1+
Stable (recommended):
pip install -U sonolink # basic
pip install -U "sonolink[speed]" # optional speed improvementsDevelopment (latest from GitHub):
pip install -U "sonolink @ git+https://github.com/sonolink/sonolink" # basic
pip install -U "sonolink[speed] @ git+https://github.com/sonolink/sonolink" # optional speed improvementsTip
On Linux/macOS use python3 -m pip, on Windows use py -3 -m pip if pip isn't on your PATH.
© 2026 SonoLink Development Team