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

# Instalação

> Baixe e configure o Orkestral no macOS, Windows ou Linux.

O Orkestral é um app desktop nativo pras três principais plataformas. Os modelos
locais vêm **embutidos no instalador**, então o app funciona 100% offline desde o
primeiro uso, sem download extra.

## Download

<CardGroup cols={3}>
  <Card title="Baixar pra macOS" icon="apple" href="https://github.com/Orkestral-AI/orkestral/releases/latest/download/Orkestral-0.1.1-arm64.dmg">
    Apple Silicon (M1+) · `.dmg`
  </Card>

  <Card title="Baixar pra Windows" icon="windows" href="https://github.com/Orkestral-AI/orkestral/releases/latest/download/Orkestral-0.1.1-x64.exe">
    x64 · `.exe` (instalador)
  </Card>

  <Card title="Baixar pra Linux" icon="linux" href="https://github.com/Orkestral-AI/orkestral/releases/latest/download/Orkestral-0.1.1-x86_64.AppImage">
    x86\_64 · `.AppImage`
  </Card>
</CardGroup>

Você também pode pegar qualquer instalador na [página de releases](https://github.com/Orkestral-AI/orkestral/releases/latest).

<Note>
  Os instaladores são grandes (\~1,7–2 GB) porque o modelo de execução local (o
  Forge) vem dentro do app, pra rodar offline desde o primeiro uso.
</Note>

## Instalar por plataforma

<Tabs>
  <Tab title="macOS">
    1. Abra o `.dmg` e arraste o **Orkestral** pra **Aplicativos**.
    2. Na primeira vez, o macOS pode avisar que o desenvolvedor não é verificado,
       clique com o botão direito no app e escolha **Abrir** (ou **Ajustes →
       Privacidade e Segurança → Abrir mesmo assim**).
    3. Abra o Orkestral.
  </Tab>

  <Tab title="Windows">
    1. Execute o instalador `.exe`.
    2. Se o **SmartScreen** aparecer, clique em **Mais informações → Executar assim
       mesmo**.
    3. Conclua o instalador e abra o Orkestral.
  </Tab>

  <Tab title="Linux">
    1. Dê permissão de execução: `chmod +x Orkestral-*.AppImage`
    2. Execute (duplo-clique ou `./Orkestral-*.AppImage`).
  </Tab>
</Tabs>

<Warning>
  Os builds **ainda não são assinados**, então o sistema mostra um aviso único na
  primeira execução. É seguro, só não há certificado de desenvolvedor ainda.
  Assinatura e notarização estão no roadmap.
</Warning>

## Primeiro uso

No primeiro run, o Orkestral configura os modelos locais, o **Forge** (execução de
código) e os **embeddings** (busca semântica). Como vêm embutidos, é um passo local
rápido, não um download grande.

Tudo é armazenado em `~/.orkestral` (banco de dados, arquivos do workspace, modelos).

## Requisitos

* **macOS** 12+ (Apple Silicon), **Windows** 10/11 (x64) ou uma distro **Linux**
  x86\_64 moderna.
* \~4 GB de espaço livre após instalar.
* Pros adapters premium (opcional): as CLIs **Claude Code** (`claude`) e/ou
  **Codex** (`codex`) instaladas e autenticadas. O Forge não precisa de nada extra.

Próximo: [Primeiros passos](/pt/quickstart).