Skip to content


Repository files navigation

CircleCI GitHub release PyPI

A Python client library for Andesite. tries to be as flexible as possible while still providing the same, consistent API. The library comes with built-in support for, but it can be used with any library of your choice.

The goodies

  • Pythonic, fully typed API including all Andesite "entities"
  • Client pools with balancing and even state migration. If one node goes down its players are seamlessly migrated to another one.
  • Custom state handlers. doesn't force you to use its state manager, not even for the client pools. It provides you with a solid in-memory one, but you can swap it out however you want.
  • Future-proof design so that if the library becomes outdated it still remains usable.


You can install the library from PyPI using pip:

pip install

Look & Feel

The following is a small example of how to use For more in-depth examples and information, please refer to the documentation.

Please keep in mind that the following example is incomplete. It only serves to demonstrate some code.

import asyncio

import andesite

client = andesite.create_client(
    "http://localhost:5000",            # REST endpoint
    "ws://localhost:5000/websocket",    # WebSocket endpoint
    None,                               # Andesite password
    549905730099216384,                 # Bot's user id

async def main() -> None:
    result = await client.search_tracks("your favourite song")
    track_info = result.get_selected_track()
    # notice that we haven't called any sort of connect method. You can
    # of course manually connect the client, but if you don't, that's no
    # biggie because will do it for you.


You can find the documentation on the project's website. Click here to open the documentation.

You can also take a look at the examples directory for a reference.


If isn't what you're looking for, first of all, please leave some feedback, but secondly here are some alternative Python client libraries which you can use: