Welcome to Noveum.ai Docs

Welcome to the Noveum.ai documentation! Here you'll find everything you need to integrate, configure, and optimize your AI applications using our comprehensive tracing and observability platform.

We provide powerful SDKs for Python and TypeScript that enable you to trace LLM calls, RAG pipelines, and multi-agent workflows with minimal code changes. Our documentation is organized to help you get started quickly while diving into advanced observability patterns and best practices.

🚀 What is Noveum.ai?

Noveum.ai is a comprehensive AI tracing and observability platform designed specifically for modern AI applications. Unlike traditional monitoring tools, Noveum understands the unique challenges of LLM applications, RAG systems, and AI agents.

Core Components

1. 🐍 Python SDK (noveum-trace)

   • Decorator-based tracing for LLM calls, agents, and RAG pipelines
   • Automatic instrumentation for popular AI frameworks
   • Context propagation across async operations

2. 📘 TypeScript SDK (@noveum/trace)

   • Framework integrations for Next.js, Express.js, and Hono
   • TypeScript-first design with full type safety
   • Universal compatibility (Node.js, Edge Runtime, browsers)

3. 📊 Noveum Platform

   • Real-time dashboard for analyzing traces and performance
   • Advanced filtering and search capabilities
   • Cost analysis and optimization insights
   • Team collaboration and project management

🏃 Quick Start

1. Choose Your SDK

pip install noveum-trace

import noveum_trace
 
# Initialize the client
noveum_trace.init(
    api_key="your-api-key",
    project="my-ai-app",
    environment="production"
)
 
# Trace LLM calls automatically
@noveum_trace.trace_llm
def call_openai(prompt: str) -> str:
    return openai.chat.completions.create(
        model="gpt-4",
        messages=[{"role": "user", "content": prompt}]
    )

2. View Your Data

Within minutes, you'll see comprehensive traces in the Noveum dashboard:

• 🔍 Request/Response details and timing
• 💰 Cost tracking across providers
• 🚀 Performance metrics (latency, throughput)
• 🐛 Error analysis and debugging context

📚 Documentation Structure

Getting Started

• Overview Introduction to Noveum.ai's tracing and observability capabilities.

• SDK Integration Step-by-step guide to integrate Python or TypeScript SDKs into your application.

• Tracing Concepts Understanding traces, spans, and observability best practices for AI applications.

• Framework Integrations Specific guides for Next.js, Express.js, FastAPI, and other popular frameworks.

Advanced Usage

• Multi-Agent Tracing Observe complex agent workflows and inter-agent communications.

• RAG Pipeline Observability Monitor retrieval, generation, and context handling in RAG systems.

• Custom Instrumentation Add custom spans and attributes for domain-specific observability.

• Performance Optimization Use tracing data to identify bottlenecks and optimize AI application performance.

Platform Features

• Dashboard Overview Navigate the Noveum platform and understand key metrics.

• Projects & Environments Organize your applications and manage different deployment environments.

• Team Collaboration Share insights and collaborate on AI application observability.

• API Reference Direct API access for custom integrations and advanced use cases.

🎯 Use Cases

LLM Application Monitoring

Track every LLM call across your application with automatic cost calculation, latency measurement, and error tracking.

RAG System Observability

Monitor the entire RAG pipeline from query understanding to document retrieval to answer generation.

Multi-Agent Workflows

Observe complex agent interactions, tool usage, and decision-making processes across distributed AI systems.

Performance Optimization

Identify slow operations, expensive API calls, and opportunities for caching or model optimization.

🔗 SDK Resources

Python SDK

• 📦 PyPI Package: noveum-trace
• 🐙 GitHub Repository: Noveum/noveum-trace
• 📖 API Documentation: Python SDK Docs

TypeScript SDK

• 📦 NPM Package: @noveum/trace
• 🐙 GitHub Repository: Noveum/noveum-trace-ts
• 📖 API Documentation: TypeScript SDK Docs

💡 Key Benefits

• 🔧 Minimal Setup: Start tracing with just a few lines of code
• 🎯 AI-Native: Purpose-built for LLM, RAG, and agent observability
• 🚀 Production Ready: Battle-tested at scale with intelligent sampling
• 🔒 Secure: End-to-end encryption with configurable data retention
• 🌍 Universal: Works across frameworks, clouds, and deployment models

🤝 Community & Support

• 💬 Discord Community: Join our Discord
• 📧 Email Support: [email protected]
• 🐛 Bug Reports: GitHub Issues
• 📖 Knowledge Base: Help Center

Ready to get started? Head to our SDK Integration Guide to begin tracing your AI applications in under 5 minutes!