> ## 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.

# O Forge

> Como o modelo local embutido executa mudanças de código com custo de API de $0.

O **Forge** é o modelo de código local embutido do Orkestral. Ele roda inteiramente
na sua máquina (Qwen2.5-Coder via `node-llama-cpp`, GGUF) e executa as mudanças de
código de verdade, então o trabalho rotineiro custa **nada** em taxas de API.

## A ideia: premium planeja, local executa

```mermaid theme={null}
flowchart TD
    P["Modelo premium"] -->|planeja a mudança| F["Forge, roda local"]
    F -->|aplica a edição| D["Pronto, custo de API zero"]
    F -.->|não consegue aplicar| E["Escala pro premium, uma vez"]
```

Um modelo premium é ótimo pra *planejar*. O Forge é ótimo (e grátis) pra *fazer*. O
Orkestral divide o trabalho pra você pagar só pelo raciocínio, não pela digitação.

## Fast Apply

O Forge anda junto com o **Fast Apply** próprio do Orkestral, um motor
determinístico que funde as edições nos seus arquivos:

<Steps>
  <Step title="Match exato">
    Aplica a mudança onde bate exatamente.
  </Step>

  <Step title="Normalizado por espaços">
    Tenta de novo ignorando diferenças de indentação/espaços.
  </Step>

  <Step title="Fuzzy seguro">
    Uma passada fuzzy de match único, e **rejeita** qualquer coisa ambígua em vez
    de escrever o conteúdo errado.
  </Step>
</Steps>

O Fast Apply mexe só nas linhas alteradas, nunca reescreve o arquivo inteiro e não
precisa de serviço externo.

## \$0 por design

<Card title="Offline e gratuito" icon="piggy-bank">
  Como o modelo é embutido e roda local, executar mudanças não usa créditos de API e
  funciona sem internet. Uma visão de custo mostra quantas execuções foram resolvidas
  localmente vs. escaladas pro modelo premium.
</Card>

## Quando escala

Se o Forge não consegue aplicar uma mudança com confiança, o Orkestral escala **uma
vez** pra um modelo premium como fallback, então a correção nunca é sacrificada pelo
custo.

<Note>
  O modelo Forge vem **dentro do instalador**, então está pronto no primeiro uso sem
  download extra.
</Note>

## Projetos do zero (greenfield)

Montar a base de um projeto novo (rodar `create-next-app`, instalar dependências) não é
edição de arquivo, é executar comandos. Em vez de o Forge escrever um `package.json` pela
metade, o setup de um projeto vazio **escala uma vez pro premium**, que roda o scaffolder
oficial e confirma que a base já compila. A partir daí o Forge customiza em cima dela.

## Veja também

<CardGroup cols={2}>
  <Card title="A Cápsula" icon="cube" href="/pt/capsule">
    Como o premium compila a tarefa numa unidade que o Forge executa com fidelidade.
  </Card>

  <Card title="Entrega provada" icon="shield-check" href="/pt/verified-delivery">
    As travas que confirmam que a mudança do Forge funciona de verdade.
  </Card>
</CardGroup>
