Opik - Unilab's Self-Hosted LLM Evaluation Platform

A fork of the original Opik project, tailored for Unilab's specific needs and hosted in our Azure tenant.

https://opik.unilabspt.com/

Installed version: 1.8.42

Note

The version is the one specified in .env.azure as OPIK_VERSION. It refers to the tag of the commit of the original Opik repository.

Quick Start

Tip

Make sure you are in the "Opik Users" group to log in.

First-Time Deployment

1. Configure Environment

   cd deployment
   nano .env.azure
   # Edit .env.azure with your Azure credentials

Important

This script will only work with DevScope's account. Run az login with it first.

2. Deploy to Azure

   ./deploy-azure.sh

Upgrading Versions

# 1. Merge upstream changes
git fetch upstream && git merge upstream/main

# 2. Update version in deployment/.env.azure
# Check the commit tag for the version.
OPIK_VERSION=new_version

# 3. Redeploy (preserves all data)
cd deployment && ./deploy-azure.sh

Cluster Management

Delete Cluster

• Go to Azure Portal → Resource Groups → opik-rg
• Delete the opik-aks cluster
• The data will be preserved (stored in persistent disks in the resource group)

Recover Data After Cluster Recreation

The deployment script automatically detects and reuses existing data disks when you redeploy. These disks are found in the opik-rg resource group, so they are not deleted with the cluster.

Simply run:

cd deployment
./deploy-azure.sh

Your existing data will be automatically preserved and reattached.

More Information

Detailed Documentation: See deployment/ folder for:

• Complete deployment guide
• Configuration options
• Troubleshooting
• Network architecture

Note

For general Opik documentation and features, visit the original repository.