atuin-graph

activity graph for atuin self hosted sync server

It connects to the PostgreSQL atuin database, using by default the db_uri setting from atuin server.toml config file

Two ways to run it are available, whether in command line or as a flask web application

Required Python version: >= 3.11 (uses the tomllib parser)

installation

pip install atuin-graph

cli / standalone

- atuin-graph: takes a username as input and outputs a atuin-{user}.png file

The -until and --from parameters allow to query from / up to a specified date, this is useful to create one png per day and create a gif with imagemagick for example (convert -delay 10 -loop 1 *.png atuin.gif)

atuin-graph -h
usage: atuin-graph [-h] --user USER [--from FROM] [--until UNTIL] [--atuin_server_config ATUIN_SERVER_CONFIG]

options:
  -h, --help            show this help message and exit
  --user USER           user to draw the graph for
  --from FROM           day (yyyy-mm-dd) to query from
  --until UNTIL         day (yyyy-mm-dd) to query until
  --atuin_server_config ATUIN_SERVER_CONFIG
                        atuin server config path

web app

This package also ships a Flask app which dynamically serves a png for a given user and optional dates

one way to run it:

GUNICORN_CMD_ARGS="--bind=127.0.0.1:8889" SCRIPT_NAME=/graph gunicorn atuin_graph.web:app

and on nginx side

location /graph {

            proxy_bind              $server_addr;
            proxy_pass              http://127.0.0.1:8889;
    }