> For the complete documentation index, see [llms.txt](https://giantgrey.gitbook.io/flowreactor/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://giantgrey.gitbook.io/flowreactor/installation.md).

# Installation

{% hint style="warning" %}
Always backup your project before updating FlowReactor!
{% endhint %}

{% hint style="info" %}
**NET 4.x API Compatibility level**: FlowReactor makes use of the excellent Odin Serializer, therefore API compatibility level **.NET 4.x** is required. You can change it in the Unity player settings.
{% endhint %}

### First time installation

1. Download FlowReactor from the package manager inside Unity.
2. Import the package and wait for compilation.
3. In Unity you can go to **Tools / FlowReactor / Welcome** to open up the welcome screen with links to more resources and support channels

{% hint style="info" %}
You can move the FlowReactor folder inside of your project wherever you want
{% endhint %}

### Settings

After compilation and as soon as you open your first graph, FlowReactor creates a settings asset file to store custom settings such as node colors and shortcuts. This file will be placed at to root of your project but you can move it wherever you want.

You can open up the settings by going to **Edit / Preferences**

### Upgrade

Remove the complete FlowReactor folder before updating to a newer version.

### Upgrade version 1.x to 2.x

**See what's new in Version 2.0 ->** [**https://flowreactor.io/whatsnew**](https://flowreactor.io/whatsnew)

{% hint style="danger" %}
Warning! Version 2 had some major refactoring, therefore graphs made with a version prior to version 2 are not 100 percent compatible and will most likely break. Meaning that you will have to fix some variable connections and or node connections.
{% endhint %}

FlowReactor will try to upgrade your v1 graph to v2 as best as possible.\
If you run into weird node drawing behaviours you can re-initialize the node by right click on the node and select: **Re-Initialize**

**Custom nodes 1.x to 2.x**

Please note that in version 2.x, all node properties have been moved to node class attributes.\
You will have to adapt your custom nodes accordingly.

{% content-ref url="/pages/KMk4hYmr4CBhvgAs3K7Q" %}
[Node Attributes](/flowreactor/in-depth/node-attributes.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://giantgrey.gitbook.io/flowreactor/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.