Skip to content

armgit / camel

Public Imported from GitHub
0

🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org

3.3 KB
Raw Blame

Langfuse Usage Guide

Langfuse is an open-source LLM engineering platform that provides tracing, evaluation, prompt management, and metrics analysis. This guide covers how to use Langfuse with the CAMEL project and how to start a Docker self-hosted service.

Table of Contents

Quick Start

1. Install Dependencies

pip install 'camel-ai[all]'

2. Environment Variables Configuration

Before using Langfuse, set the following environment variables:

# Enable Langfuse tracing
export LANGFUSE_ENABLED="true"

# Langfuse service configuration (optional, if using cloud service)
export LANGFUSE_PUBLIC_KEY="pk-lf-your-public-key"
export LANGFUSE_SECRET_KEY="sk-lf-your-secret-key"
export LANGFUSE_HOST="https://cloud.langfuse.com"  # or your self-hosted address

# Debug mode (optional)
export LANGFUSE_DEBUG="false"

3. Basic Usage Example

from camel.agents import ChatAgent
from camel.models import ModelFactory
from camel.types import ModelPlatformType, ModelType

# Create model
model = ModelFactory.create(
    model_platform=ModelPlatformType.OPENAI,
    model_type=ModelType.GPT_4_1_MINI,
)

# Define system message
sys_msg = "You are a helpful AI assistant, skilled at answering questions."

# Create agent
camel_agent = ChatAgent(system_message=sys_msg, model=model)

# User message
user_msg = "Calculate the square root after adding 222991 and 1111"

# Execute conversation (automatically traced)
response = camel_agent.step(user_msg)
print(response.msgs[0].content)

Environment Configuration

Environment Variables Description

Variable Required Default Description
LANGFUSE_ENABLED Yes false Enable/disable Langfuse tracing
LANGFUSE_PUBLIC_KEY No* - Langfuse public key
LANGFUSE_SECRET_KEY No* - Langfuse secret key
LANGFUSE_HOST No https://cloud.langfuse.com Langfuse service address
LANGFUSE_DEBUG No false Enable debug mode

*Note: Required when using cloud service or authenticated self-hosted service

Docker Self-Hosted Deployment

If you want to self-host the Langfuse service, you can quickly deploy it using Docker Compose.

Requirements

  • git
  • docker & docker compose -> Use Docker Desktop on Mac or Windows

Clone Langfuse Repository

Get a copy of the latest Langfuse repository:

git clone https://github.com/langfuse/langfuse.git
cd langfuse

Start the Application

Update the secrets in the docker-compose.yml and then run the langfuse docker compose using:

docker compose up

Watch the containers being started and the logs flowing in. After about 2-3 minutes, the langfuse-web-1 container should log "Ready". At this point you can proceed to the next step.

Done

And you are ready to go! Open http://localhost:3000 in your browser to access the Langfuse UI.

Related Links