sonolink 1.1.1

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

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

Documentation · Discord Server

---

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
• Multi-library native support for discord.py, py-cord, disnake, and nextcord

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)
• 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+

Install

Stable (recommended):

pip install -U sonolink # basic
pip install -U "sonolink[speed]" # optional speed improvements

Development (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 improvements

[!TIP] 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