Notice: Gentrace has shut down. This repository is now read-only and provided as-is for archival and educational purposes. No further updates, support, or maintenance will be provided.

Gentrace

Gentrace is a comprehensive platform for AI application observability, evaluation, and testing. This monorepo contains all the components needed to run Gentrace locally or deploy it to production.

🏗️ Repository Structure

Core Application

• app/ - Main Gentrace application (Next.js web app, API, and backend services)
• local/ - Local development environment with Docker Compose setup for ClickHouse, PostgreSQL, Kafka, and other services

Documentation & Content

• docusaurus/ - [DEPRECATED] Legacy documentation website built with Docusaurus
• mintlify/ - Main documentation content hosted on Mintlify platform
• mintlify-worker/ - Cloudflare Worker that routes documentation requests from next.gentrace.ai/docs to Mintlify-hosted content
• sanity/ - [DEPRECATED] Sanity CMS for content management (CMS for marketing content - no longer actively maintained)

Demos & Examples

• demo/ - Demo applications showcasing Gentrace features
• demo-agent/ - AI agent demonstration
• demo-banking-chatbot/ - Banking chatbot example

Infrastructure & DevOps

• kubernetes/ - Kubernetes deployment configurations and Helm charts
• otel-dev/ - OpenTelemetry Collector development environment

Legacy

• benchmark/ - Legacy benchmarking tools (being phased out in favor of local/)

🚀 Quick Start

Prerequisites

This repository requires different setup steps for different components. There is no single "run everything" command at the top level.

Core Components

1. Local Infrastructure (Required for app development):

   cd local
   cp .env.example .env
   yarn start

2. Main Application:

   cd app
   # Follow the detailed setup instructions in app/README.md

3. Documentation Site (Mintlify):

   cd mintlify
   mintlify dev
   # See mintlify/README.md for setup instructions

📚 Key Resources

• Application Setup - Complete guide to running the Gentrace application
• Local Development - Docker Compose setup for local development
• Documentation Site - How to work with the documentation
• Kubernetes Deployment - Production deployment guides

🛠️ Development Workflow

This is a Yarn workspace monorepo. Key commands:

# Install dependencies for all workspaces
yarn install

# Run linting across the monorepo
yarn lint-staged

# Work with specific packages
cd app && yarn dev
cd mintlify && mintlify dev

🏢 Architecture Overview

Gentrace consists of:

• Web Application (app/) - Next.js frontend and API
• Database Layer - PostgreSQL for application data, ClickHouse for analytics
• Message Queue - Kafka for event streaming
• Documentation (mintlify/) - User-facing documentation
• Content Management (sanity/) - [DEPRECATED] CMS for marketing content - no longer in use
• Observability (otel-dev/) - OpenTelemetry setup for monitoring
• Mintlify Documentation (mintlify/ + mintlify-worker/) - OpenTelemetry documentation hosted on Mintlify with custom routing

📚 Documentation Migration to Mintlify

Gentrace is transitioning from Docusaurus to Mintlify as the primary documentation platform:

Documentation Status

• Docusaurus (docusaurus/) - [DEPRECATED] Legacy documentation system being phased out
• Mintlify (mintlify/ + mintlify-worker/) - New primary documentation platform for all Gentrace content

How Mintlify Works

The Mintlify setup consists of two components working together:

1. mintlify/ - Contains the actual documentation content:

   • OpenTelemetry getting started guides
   • SDK reference documentation
   • API reference with OpenAPI integration
   • Integration guides for popular AI providers

2. mintlify-worker/ - Cloudflare Worker that enables seamless routing:

   • Routes requests from next.gentrace.ai/docs/* to Mintlify-hosted content
   • Maintains consistent domain experience for users
   • Redirects non-documentation paths to the main website

Why Mintlify?

We're migrating to Mintlify because it provides:

• Superior API documentation features with OpenAPI integration
• Better developer experience with modern documentation tooling
• Seamless updates without main application deployments
• Enhanced search and navigation capabilities
• Built-in versioning and internationalization support

📖 Learn More

• Visit our documentation to learn about using Gentrace
• Check out the demo applications to see Gentrace in action
• Review the API documentation for integration details

---

For specific setup instructions, refer to the README files in each directory.