---
title: "Setting up Rossum tool"
slug: "setting-up-rossum-tool"
updated: 2025-07-09T08:45:16Z
published: 2025-07-09T08:45:16Z
canonical: "knowledge-base.rossum.ai/setting-up-rossum-tool"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge-base.rossum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting up Rossum tool

To have advanced access to the configuration of your account, you will want to use our command-line configuration tool Rossum.

![](https://cdn.document360.io/1bb6f6bc-c04c-4ace-a1e8-8c4cfd3fbc98/Images/Documentation/Devs%20-%20Setting%20up%20Rossum%20tool%2001.png)

## Installing rossum

## Windows

On Windows, Rossum is installed like any other standalone application. [Download the latest Rossum version](https://github.com/rossumai/rossum/releases) and go through the installation wizard. You can launch it either from the Start menu or the command prompt.

## MacOSX

On Mac, Rossum is installed as a Python script.

We will be working from a Mac terminal shell window. First, [make sure you have Python3 installed](https://docs.python-guide.org/starting/install3/osx/). Next, install the tool itself by

```plaintext
pip install rossum
```

and run it simply by typing

```plaintext
rossum
```

in the terminal shell.

## Linux

Rossum is installed as a Python script in a terminal shell window on Linux. Make sure you have at least Python 3.6 installed on your system. The tool itself is installed by either

```plaintext
pip install rossum
```

or

```plaintext
pip3 install rossum
```

depending on your Linux distribution. To run it, type

```plaintext
rossum
```

in the terminal shell.

## Configuring Rossum

The Rossum tool uses standard Rossum APIs and needs to authenticate them. Type in the configure command on the first run to get everything set up. Go with the default API endpoint if asked, but then type in the same username and password that you use to log into Rossum. The credentials will be saved on your computer for the next invocations of the tool.

In the rest of our guide, we will mostly show specific examples of the tool, but you will find extra tips & tricks about it on [the Rossum GitHub page](https://github.com/rossumai/rossum).