Skip to main content

Python wrapper for Austin, the CPython frame stack sampler.

Project description


Python wrapper for Austin

GitHub Actions: Tests GitHub Actions: Checks Codecov Documentation
PyPI Downloads

Synopsis • Installation • Usage • Compatibility • Documentation • Contribute

Buy Me A Coffee


The austin-python package is a Python wrapper around the Austin binary that provides convenience classes to quickly develop your statistical profiling tools. Whether your code is thread-based or asynchronous, austin-python has you covered. This is, for instance, how you would turn Austin into a Python application:

from austin.aio import AsyncAustin

# Make your sub-class of AsyncAustin
class EchoAsyncAustin(AsyncAustin):
    def on_ready(self, process, child_process, command_line):
        print(f"Austin PID: {}")
        print(f"Python PID: {}")
        print(f"Command Line: {command_line}")

    def on_sample_received(self, line):

    def on_terminate(self, data):

# Use the Proactor event loop on Windows
if sys.platform == "win32":

    # Start the Austin application with some command line arguments
    austin = EchoAsyncAustin()
        austin.start(["-i", "10000", "python3", ""])
except (KeyboardInterrupt, asyncio.CancelledError):

The austin-python package is at the heart of the Austin TUI and the Austin Web Python applications. Go check them out if you are looking for full-fledged usage examples.

Included with the package come two applications for the conversion of Austin collected output, which is in the form of collapsed stacks, to either the Speedscope JSON format or the Google pprof format. Note, however, that the Speedscope web application supports Austin native format directly.


This package can be installed from PyPI with

pip install --user austin-python --upgrade

Please note that austin-python requires the Austin binary. The default lookup locations are, in order,

  • current working directory;
  • the AUSTINPATH environment variable which gives the path to the folder that contains the Austin binary;
  • the .austinrc TOML configuration file in the user's home folder, e.g. ~/.austinrc on Linux (see below for a sample .austinrc file);
  • the PATH environment variable.

A sample .austinrc file would look like so

binary = "/path/to/austin"


A simple example of an echo application was shown above. Other examples using, e.g., threads, can be found in the official documentation. You can also browse through the code of the Austin TUI and the Austin Web Python applications to see how they leverage austin-python.

Format conversion

As it was mentioned before, this package also comes with two scripts for format conversion, namely austin2speedscope and austin2pprof. They both take two mandatory arguments, that is, the input and output file. For example, to convert the Austin profile data file myscript.aprof to the Google pprof data file myscript.pprof, you can run

austin2pprof myscript.aprof myscript.pprof

The package also provide the austin-compress utility to compress the Austin raw samples by aggregation.


The latest austin-python package is tested on Linux, macOS and Windows with Python 3.8-3.12.


The official documentation is hosted on at


If you want to help with the development, then have a look at the open issues and have a look at the contributing guidelines before you open a pull request.

You can also contribute to the development by either becoming a Patron on Patreon, by buying me a coffee on BMC or by chipping in a few pennies on PayPal.Me.

Buy Me A Coffee

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

austin_python-1.7.1.tar.gz (198.9 kB view hashes)

Uploaded Source

Built Distribution

austin_python-1.7.1-py3-none-any.whl (69.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page