# Belvedir

## Docs

- [Fractal API Authentication: API Keys and Bearer Tokens](https://docs.belvedir.ai/api-reference/authentication.md): Learn how to authenticate requests to the Fractal API using your API key via the Authorization Bearer header or the x-api-key header.
- [Fractal REST API Reference: Traces and Authentication](https://docs.belvedir.ai/api-reference/overview.md): Explore the Fractal REST API: ingest OpenTelemetry traces, authenticate requests, and integrate directly with the Fractal platform.
- [POST /api/v1/traces — Ingest OpenTelemetry Spans](https://docs.belvedir.ai/api-reference/traces.md): Send OpenTelemetry trace data to Fractal in OTLP JSON format. This endpoint powers the trace analysis dashboard and is called automatically by the SDK.
- [Environments](https://docs.belvedir.ai/benchmarks/environments.md): Distilled reproducible settings from your production traffic.
- [Benchmarks](https://docs.belvedir.ai/benchmarks/overview.md): Run agent harnesses in isolated CPU or GPU sandboxes and collect scores.
- [Fractal SDK Environment Variables: Setup and Best Practices](https://docs.belvedir.ai/guides/environment-variables.md): Learn which environment variables the Fractal SDK requires and how to set them in local development, Vercel, and other hosting platforms.
- [Using Fractal with Next.js: Setup and Initialization](https://docs.belvedir.ai/guides/nextjs.md): Learn how to add Fractal tracing to your Next.js app with the correct initialization order for both server and Edge runtime environments.
- [Deploying Fractal-Instrumented Next.js Apps on Vercel](https://docs.belvedir.ai/guides/vercel.md): Configure the Node.js runtime and set your environment variables on Vercel so Fractal SDK traces are captured correctly in production.
- [How Belvedir Works](https://docs.belvedir.ai/how-it-works.md): The six-stage pipeline Belvedir uses: instrument, collect, segment, group, clean, and optimize.
- [Belvedir Documentation](https://docs.belvedir.ai/index.md): Instrument your LLM agents, collect traces, and improve them automatically with Belvedir.
- [Hosted Inference](https://docs.belvedir.ai/inference/hosted.md): Trace agents calling hosted OpenAI-compatible endpoints like Together, Fireworks, Groq, and OpenRouter.
- [Local Models](https://docs.belvedir.ai/inference/local-models.md): Trace agents running open models locally via Ollama.
- [Mixture of Models](https://docs.belvedir.ai/inference/mixture-of-models.md): Route each step to whichever model fits and tune the routing from production data.
- [Belvedir Quickstart](https://docs.belvedir.ai/quickstart.md): Install the Belvedir SDK, connect it to your AI application, and start seeing live LLM traces in your dashboard in under 5 minutes.
- [Fractal Loop SDK Configuration Options and Reference](https://docs.belvedir.ai/sdk/configuration.md): Learn how to configure the Fractal Loop SDK: set your API key, platform base URL, application name, and control span batching behavior.
- [Install the Fractal Loop SDK for Your Node.js Project](https://docs.belvedir.ai/sdk/installation.md): Add @fractalresearch/loop to your Node.js project and start capturing LLM traces automatically — no manual instrumentation needed.
- [Python SDK](https://docs.belvedir.ai/sdk/python.md): Trace Python agents with the fractal-loop package.
- [LLM Providers Supported by Fractal Auto-Instrumentation](https://docs.belvedir.ai/sdk/supported-providers.md): Fractal auto-instruments eight LLM providers with zero extra code. OpenAI, Anthropic, Cohere, Bedrock, Vertex AI, and more are fully supported.
- [Model Training](https://docs.belvedir.ai/training/overview.md): Fine-tune an open model on your own production traffic with LoRA adapters.
- [Fix Fractal SDK Issues: Traces, Vercel, and Init Order](https://docs.belvedir.ai/troubleshooting/common-issues.md): Resolve the most common reasons LLM traces aren't appearing in your Fractal dashboard, from Vercel runtime mismatches to initialization ordering.
- [Fractal SDK FAQ: Runtime, Traces, API Keys, and Multi-App](https://docs.belvedir.ai/troubleshooting/faq.md): Answers to common questions about the Fractal SDK: runtime support, LLM client setup, trace delivery timing, API key safety, and multi-app usage.