Command-line interface#

giskard#

Giskard Command Line

giskard [OPTIONS] COMMAND [ARGS]...

Options

--version#

Show the version and exit.

server#

Giskard UI management

giskard server [OPTIONS] COMMAND [ARGS]...

clean#

Delete Docker container, container (and possibly a volume) associated with the current version of Giskard Server
giskard server clean [OPTIONS]

Options

--data#

Delete user data (giskard-home volume)

-v, --verbose#

Enable verbose logging

diagnose#

Save server logs to a local archive (Useful for support).
giskard server diagnose [OPTIONS]

Options

-o, --out_path <local_dir>#

Destination directory to save diagnose archive to

-v, --verbose#

Enable verbose logging

expose#

Expose your local Giskard Server to the outside world using ngrok to use in notebooks like Google Colab
giskard server expose [OPTIONS]

Options

--token <token>#

Required In case you have an ngrok account, you can use a token generated from https://dashboard.ngrok.com/get-started/your-authtoken

-v, --verbose#

Enable verbose logging

logs#

Prints logs of server services
giskard server logs [OPTIONS] [[backend|frontend|worker|db]]

Options

-l, --lines <nb_lines>#

Number of log lines to show

-f, --follow#

Follow the logs stream

-v, --verbose#

Enable verbose logging

Arguments

SERVICE#

Optional argument

restart#

Restart Giskard Server.

Stops any running Giskard server and starts it again.

giskard server restart [OPTIONS] [[backend|frontend|worker|db]]

Options

--hard#

Hard restart. Restarts the whole container

-v, --verbose#

Enable verbose logging

Arguments

SERVICE#

Optional argument

start#

Start Giskard Server.

By default, the server starts detached and will run in the background. You can attach to it by using -a

giskard server start [OPTIONS]

Options

-a, --attach#

Starts the server and attaches to it, displaying logs in console.

--version <version>#

Version of Giskard server to start

-v, --verbose#

Enable verbose logging

status#

Check if server container is running and status of each internal service
giskard server status [OPTIONS]

Options

-v, --verbose#

Enable verbose logging

stop#

Stop Giskard Server.

Stops a running Giskard server. Does nothing if Giskard server is not running.

giskard server stop [OPTIONS]

Options

-v, --verbose#

Enable verbose logging

upgrade#

Update Giskard Server. Uses the latest available version if not specified.
giskard server upgrade [OPTIONS] [VERSION]

Options

-v, --verbose#

Enable verbose logging

Arguments

VERSION#

Optional argument

worker#

ML Worker management

giskard worker [OPTIONS] COMMAND [ARGS]...

logs#

giskard worker logs [OPTIONS]

Options

-v, --verbose#

Enable verbose logging

-n, --lines <lines>#

Output the last N lines of the log file, 10 lines are displayed by default

-f, --follow#

Output appended data as new logs are being generated

restart#

Restart ML Worker

giskard worker restart [OPTIONS]

Options

-v, --verbose#

Enable verbose logging

-u, --url <url>#

Remote Giskard server url

-s, --server#

Server mode. Used by Giskard embedded ML Worker

-k, --api-key <api_key>#

Giskard server API key

-t, --hf-token <hf_token>#

Access token for Giskard hosted in a private Hugging Face Spaces

start#

Start ML Worker.

ML Worker can be started in 2 modes:

  • server: used by default by an ML Worker shipped by Giskard. ML Worker acts as a server that Giskard connects to.

  • client: ML Worker acts as a client and should connect to a running Giskard instance

    by specifying this instance’s host and port.

giskard worker start [OPTIONS]

Options

-v, --verbose#

Enable verbose logging

-u, --url <url>#

Remote Giskard server url

-s, --server#

Server mode. Used by Giskard embedded ML Worker

-k, --key <api_key>#

Giskard server API key

-d, --daemon#

Should ML Worker be started as a Daemon in a background

-t, --hf-token <hf_token>#

Access token for Giskard hosted in a private Hugging Face Spaces

Environment variables

GSK_API_KEY

Provide a default for --key

GSK_HF_TOKEN

Provide a default for --hf-token

stop#

Stop running ML Workers

giskard worker stop [OPTIONS]

Options

-v, --verbose#

Enable verbose logging

-u, --url <url>#

Remote Giskard server url

-s, --server#

Server mode. Used by Giskard embedded ML Worker

-a, --all#

Stop all running ML Workers