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

# Installation

> Get started with Marvin in under a minute

## Requirements

* Python 3.10 or higher
* An API key from an LLM provider (OpenAI by default)

## Install `marvin`

The easiest way to install Marvin is a package manager like `pip` or [`uv`](https://docs.astral.sh/uv/):

<CodeGroup>
  ```bash uv theme={null}
  # add marvin to your project
  uv add marvin
  # add marvin to your script
  uv add --script some_script.py marvin
  # run a python process with marvin installed ephemerally
  uv run --with marvin some_script.py
  ```

  ```bash pip theme={null}
  pip install marvin
  ```
</CodeGroup>

## Configure your LLM provider

By default, Marvin uses OpenAI's models. Set your API key as an environment variable:

```bash theme={null}
export OPENAI_API_KEY="your-api-key"
```

To use another provider, see the docs on [configuring LLMs](/guides/configure-llms).

## Development Installation

For development, install Marvin with development dependencies:

<CodeGroup>
  ```bash uv theme={null}
  git clone https://github.com/prefecthq/marvin.git
  cd marvin
  uv venv && source .venv/bin/activate
  uv sync --dev
  ```

  ```bash pip theme={null}
  git clone https://github.com/prefecthq/marvin.git
  cd marvin
  python -m venv .venv && source .venv/bin/activate
  pip install -e ".[dev]"
  ```
</CodeGroup>

## What's Next?

* Follow the [Quickstart](/quickstart) guide to build your first AI application
* Learn about [Tasks](/concepts/tasks), the building blocks of AI workflows
* Explore [Agents](/concepts/agents) to create specialized AI workers
* Read about [Threads](/concepts/threads) for managing conversation context