---
title: "Quickstart"
description: "Build Cortavyn from source and run a provider example."
---

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

# Quickstart

The current development version is `0.1.0-SNAPSHOT`.

```shell
git clone https://github.com/Cortavyn/Cortavyn.git
cd Cortavyn
mvn verify
```

Run an example with credentials supplied through its provider environment variable:

```shell
OPENAI_API_KEY=... mvn -pl :cortavyn-example-openai-chat -am package -Prun-example
```

> **Keep providers at the edge**
>
> Application code should depend on Cortavyn's portable contracts. Add a provider adapter only where the application constructs its `ChatModel`.

Next: learn [model and tool concepts](/concepts/model-and-tools) or create a [Chat agent](/chat/quickstart).

Source: https://docs.cortavyn.org/start-here/quickstart/index.mdx