sonolink 1.0.1

A high-performance Lavalink v4 wrapper for Python, inspired by WaveLink.

SonoLink is a high-performance Lavalink v4 wrapper for Python, inspired by WaveLink.

Documentation · Discord

---

Features

• 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
• Built-in support for discord.py, pycord, and disnake

Documentation

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.

Installation

[!NOTE] A virtual environment is recommended, especially on Linux where the system Python may restrict package installations.

Requirements:

• Python 3.12 or higher
• A running Lavalink 4.x server (guide on setup)
• Any of the supported libraries:
  • discord.py[voice] 2.7+
  • py-cord[voice] 2.8+
  • disnake[voice] 2.12+

To install the stable version from PyPI:

# Linux/macOS
python3 -m pip install -U sonolink

# Windows
py -3 -m pip install -U sonolink

To install with optional speed improvements:

# Linux/macOS
python3 -m pip install -U "sonolink[speed]"

# Windows
py -3 -m pip install -U "sonolink[speed]"

© 2026 SonoLink Development Team