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

# Introduction

> Systematically evaluate and improve your AI agents through realistic conversation simulations

OneRun is an open-source platform for evaluating AI agent performance through realistic conversation simulations. Deploy it yourself, customize it for your needs, and build better agents with complete control over your evaluation process.

## What OneRun Does

* **Test your agents** against diverse, AI-generated personas in realistic scenarios
* **Measure performance** with custom objectives and scoring criteria
* **Track improvements** over time as you iterate on your agent
* **Deploy anywhere** - self-hosted, on-premise, or in your preferred cloud

## How OneRun Works

<Steps>
  <Step title="Define Your Agent">
    Create an agent profile that represents your AI system and its intended purpose
  </Step>

  <Step title="Set Evaluation Objectives">
    Define what success looks like with custom scoring criteria for different aspects of performance
  </Step>

  <Step title="Create Test Scenarios">
    Design realistic simulation scenarios that reflect your agent's real-world use cases
  </Step>

  <Step title="Generate Diverse Personas">
    Automatically create varied conversation participants with unique backgrounds and characteristics
  </Step>

  <Step title="Run Conversations">
    Execute realistic dialogues between your agent and generated personas through your custom worker
  </Step>

  <Step title="Analyze Results">
    Review detailed performance metrics, identify patterns, and discover improvement opportunities
  </Step>
</Steps>

## Why Choose OneRun?

**Open Source & Self-Hosted**\
Full control over your data, evaluations, and deployment. No vendor lock-in.

**Framework Agnostic**\
Works with any AI framework - LangChain, direct API calls, or custom solutions.

**Production Ready**\
Built for teams serious about AI quality with systematic evaluation processes.

## Get Started Today

<CardGroup cols={2}>
  <Card title="Quick Start Guide" href="/quickstart">
    Get your first simulation running in under 10 minutes
  </Card>

  <Card title="Core Concepts" href="/concepts/projects">
    Understand the key concepts that power OneRun evaluations
  </Card>

  <Card title="Use Cases & Examples" href="/use-cases">
    See how teams use OneRun across different industries
  </Card>

  <Card title="Worker Examples" href="/concepts/workers">
    See complete examples of agents integrated with OneRun
  </Card>
</CardGroup>

## Ready to Build Better Agents?

OneRun transforms agent development from guesswork into a systematic, data-driven process. Since it's open source, you have complete control over your evaluation process and data.

<Note>
  OneRun is designed for teams serious about AI agent quality. Deploy it anywhere and customize it for your specific needs.
</Note>