Use Cheshire Cat without stress

Nicola Procopio
Mad Chatter Tea Party
3 min readMay 4, 2024

--

In the support discord channel some of the recurring questions are about problems or unfamiliarity with Docker, which is the only dependency of our beloved Cheshire Cat.

In this short tutorial we will see how to use kitty with zero stress even if you are not familiar with shell, docker or WSL.

Since so many of these questions were asked by Windows users the tutorial is on Windows 10, but you can use it on Macs as well.

Step 1: Rancher Desktop

Rancher is an open-source application that provides all the essentials to work with containers and Kubernetes on the desktop.

Developed and maintained by SUSE, it is super easy to use all you have to do is download the installer from the official site.

I used a “clean system” without Docker or WSL, having these components already in the system may not make the process work.

Run the installer…

I Accept…Next…OK…Next…Finish

At the first start Rancher asks us which container engine we want to use, we leave the default one (we can also change it later if we want).

After choosing ok the Rancher window will open and start loading all configurations (this process will be there at every startup).

When the loading is complete we can move to the terminal.

Step 2: Cheshire Cat

Go to Cheshire Cat core on Github and copy the command to start the cat.

docker run - rm -it -p 1865:80 ghcr.io/cheshire-cat-ai/core:latest

Step 3: Command Prompt

Open the command prompt and paste the row copied in the previous step.

The Cheshire Cat will be started, when you see the logo it will be ready for us to start having fun.

If you don’t want to use the demo but have already downloaded/cloned the project you need to place in the folder containing the docker-compose.yml file and write

docker compose up

Step 4: have fun!

Let’s type in the browser the admin address https://localhost:1865/admin and have fun!

--

--

Nicola Procopio
Mad Chatter Tea Party

Data Scientist and Open Source enthusiast. After many years of indecision whether to open a medium profile or not, here I am. I write in English and Italian.