Approach Cobalt Research Team Docs Get In Touch

Docs › Getting Started › Setup

Setup

Installation

Cobalt is available as a Python package. You can install it using pip:

pip install cobalt-ai

To upgrade to the latest version:

pip install --upgrade cobalt-ai

Setting Up Your Environment

We recommend using a virtual environment to manage your Cobalt installation. You can use either conda or venv.

Using conda

Create and activate a new conda environment:

conda create -n cobalt-env python=3.10
conda activate cobalt-env
pip install cobalt-ai

Using venv

Create and activate a virtual environment with venv:

python -m venv cobalt-env
source cobalt-env/bin/activate
pip install cobalt-ai

On Windows, activate with:

cobalt-env\Scripts\activate

Configuring Your License

Free / Trial Registration

To register for noncommercial or trial usage, run:

import cobalt
cobalt.register_license()

This will request your name and email address and configure a license key. If you have already registered Cobalt on a different computer, this will link your computer with the previous registration.

Commercial License

If you have a commercial license key, configure it with:

import cobalt
cobalt.setup_license()

This prompts for your license key and saves it to ~/.config/cobalt/cobalt.json.

You can verify your license at any time:

cobalt.check_license()

API Client Setup

If you plan to use API-powered features (such as LLM-based analysis), set up the API client:

cobalt.setup_api_client()

This will update or add the API key to the JSON config file.

Next Steps

Once installed and licensed, you are ready to start using Cobalt: