Skip to main content
All CollectionsDeveloper Guides
Installing the Kodexa CLI
Installing the Kodexa CLI

Learn how to install the Kodexa CLI

Updated over a week ago

Kodexa command line tools provide an easy way to work with a Kodexa platform instance from the command line. The tools are built on top of the Python SDK and provide a simple way to interact with the platform.

Installation

The Kodexa command line tools are available on PyPi and can be installed with pip:

$ pip install kodexa-cli

Usage

The Kodexa command line tools are available as a single command called kodexa. You can see the available commands by running kodexa --help.

Logging into Kodexa

The first thing you need to do is log into a Kodexa platform instance. You can do this by running the login command:

$ kodexa login

You will need to provide the URL of the Kodexa platform instance you want to log into. You can also provide the email and password for the Kodexa platform instance.

Once you have successfully logged in you can see the details of the Kodexa platform instance you are logged into by running the platform command:

$ kodexa platform

Your personal API token will be stored in your home directory, based on your operating system it will be:

  • macOS ~/Library/Application Support/kodexa-cli

  • Linux ~/.local/share/kodexa-cli

  • Windows C:\\Documents and Settings\{User}\\Application Data\\Local Settings\\kodexa\\kodexa-cli or C:\\Documents and Settings\{User}\\Application Data\\kodexa\\kodexa-cli

This file is used to authenticate you to the Kodexa platform instance. You can also provide the API token as an environment variable called KODEXA_ACCESS_TOKEN.

Did this answer your question?