> ## Documentation Index
> Fetch the complete documentation index at: https://docs.belvedir.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Belvedir Documentation

> Instrument your LLM agents, collect traces, and improve them automatically with Belvedir.

Belvedir is an observability and auto-improvement platform for LLM agents. Install the SDK, wrap your agent runs in sessions, and Belvedir segments the traces into tasks, groups similar work together, and runs improvement loops — prompt evolution, memory harness updates, and LoRA fine-tuning — against your production traffic.

## Where to start

* [Quickstart](/quickstart) — get traces flowing in under 5 minutes with the Node SDK.
* [Python SDK](/sdk/python) — same concepts, context managers instead of callbacks.
* [How It Works](/how-it-works) — the six-stage pipeline: instrument, collect, segment, group, clean, optimize.

## What you can do

* **Trace** every LLM and tool call from OpenAI, Anthropic, Cohere, Bedrock, Vertex AI, and more.
* **Segment** sessions into tasks automatically and gather similar tasks into groups.
* **Optimize** with prompt evolution (GEPA), memory harness updates, and LoRA fine-tuning that open PRs against your GitHub repo.
* **Benchmark** any agent harness in an isolated CPU or GPU sandbox against SWE-bench, τ-bench, GAIA, and more.
* **Train** open models on your successful production traffic and download the LoRA adapter.

## Supported runtimes

The Node SDK (`@fractalresearch/loop`) and Python SDK (`fractal-loop`) both auto-instrument the major LLM providers. Local models via [Ollama](/inference/local-models) and hosted OpenAI-compatible endpoints ([Together](https://together.ai), [Fireworks](https://fireworks.ai), [Groq](https://groq.com), [OpenRouter](https://openrouter.ai), [vLLM](https://docs.vllm.ai)) work out of the box — see [Hosted Inference](/inference/hosted).
