Installation

Gaussia uses a modular dependency system, allowing you to install only the components you need.

Requirements

Python 3.11 or higher
uv (recommended) or pip

Basic Installation

uv add gaussia

pip install gaussia

poetry add gaussia

Optional Dependencies

Gaussia provides optional dependency groups for each metric and feature:

Metrics

Extra	Description	Dependencies
`toxicity`	Toxicity metric with clustering	sentence-transformers, hdbscan, umap-learn, nltk, numpy, pandas
`bias`	Bias metric with guardian models	torch
`vision`	Vision similarity and hallucination	numpy, sentence-transformers, torch
`humanity`	Humanity metric with NRC lexicon	numpy, pandas
`regulatory`	Regulatory compliance metric	torch, accelerate

Features

Extra	Description	Dependencies
`generators`	Synthetic dataset generation	langchain-core
`explainability`	Token attribution analysis	interpreto, torch, transformers
`prompt-optimizer`	Prompt optimization	optuna

Combined Extras

Extra	Description
`metrics`	All metric extras combined
`all`	All metrics and features

Installation Examples

# Install with toxicity metric support
uv add "gaussia[toxicity]"

# Install multiple metrics
uv add "gaussia[toxicity,bias,vision]"

# Install everything
uv add "gaussia[all]"

LLM Provider Dependencies

Several metrics require LangChain-compatible chat models. Install your preferred provider:

uv add langchain-openai

uv add langchain-groq

uv add langchain-google-genai

uv add langchain-anthropic

uv add langchain-ollama

Verifying Installation

import gaussia

# Check version
print(f"Gaussia version: {gaussia.__version__}")

# Verify imports
from gaussia.metrics.toxicity import Toxicity
from gaussia.core.retriever import Retriever
from gaussia.schemas.common import Dataset, Batch

print("Installation successful!")

Troubleshooting

ImportError: No module named 'sentence_transformers'

Install the toxicity extras:

uv add "gaussia[toxicity]"

ImportError: No module named 'langchain_openai'

Install your preferred LLM provider:

uv add langchain-openai

CUDA/GPU issues with sentence-transformers

For CPU-only installation:

uv add torch --index-url https://download.pytorch.org/whl/cpu
uv add "gaussia[toxicity]"

Python version incompatibility

Ensure you’re using Python 3.11+:

python --version
# If needed, use pyenv to install a compatible version
pyenv install 3.11.0
pyenv local 3.11.0

Getting started

Core concepts

Metrics

Integrations

Advanced

Installation

Installation

Requirements

Basic Installation

Optional Dependencies

Metrics

Features

Combined Extras

Installation Examples

LLM Provider Dependencies

Verifying Installation

Troubleshooting

Next Steps

Quickstart

Core Concepts

​Installation

​Requirements

​Basic Installation

​Optional Dependencies

​Metrics

​Features

​Combined Extras

​Installation Examples

​LLM Provider Dependencies

​Verifying Installation

​Troubleshooting

​Next Steps

Quickstart

Core Concepts

Installation

Requirements

Basic Installation

Optional Dependencies

Metrics

Features

Combined Extras

Installation Examples

LLM Provider Dependencies

Verifying Installation

Troubleshooting

Next Steps