Documentation

Installation

Supported installation paths and environment setup.

Requirements

Python 3.11+
SQLite (auto-created at ~/.tracellm/traces.db)

Storage

TraceLLM uses SQLite for trace storage. The database is automatically created at ~/.tracellm/traces.db.

No configuration required:

No database setup required

Prerequisites

Python 3.10 or later
SQLite 3.x (bundled with Python, auto-created)
pip (Python package manager, included with Python 3.10+)

Info

TraceLLM uses SQLite for local storage. The database is automatically created at ~/.tracellm/traces.db on first run. No external database service required.

Install TraceLLM

The recommended install path is via pip. All runtime dependencies — including the CLI, SDK, and WebSocket client — are bundled in a single package.

terminalCopy

bash

pip install tracellm-cli

SetupCopy

bash

# No environment variables needed — SQLite auto-creates
# ~/.tracellm/traces.db on first run

# Start
tracellm start

Tracey Guide

No environment variables needed for storage — SQLite auto-creates ~/.tracellm/traces.db on first run. Just run tracellm start to launch the stack.

To install with optional extras:

terminalCopy

bash

pip install "tracellm[openai]"     # OpenAI integration
pip install "tracellm[groq]"       # Groq integration
pip install "tracellm[langchain]"   # LangChain integration
pip install "tracellm[all]"         # All integrations

Verify Installation

Confirm TraceLLM installed correctly:

terminalCopy

bash

tracellm --version
tracellm --help

You should see the version number and a list of available commands. To verify the full stack starts correctly:

terminalCopy

bash

tracellm start --check

Tip

start --check runs a health probe on each service without keeping the process running.

Troubleshooting

Common installation issues and their fixes:

Issue	Solution
pip install fails	Upgrade pip: pip install --upgrade pip
SQLite database not created	Check ~/.tracellm/ directory permissions — it is auto-created
Port 3000 already in use	Set TRACELLM_PORT=3001 before starting
WebSocket won't connect	Check firewall rules for port 3200
Command not found after install	Verify your Python bin directory is in PATH
ImportError in SDK code	Ensure no other tracellm versions are installed: pip list \| grep tracellm