Instalação e pré-requisitos

O Fito tem duas metades. Você navega por ele no navegador, o que não exige instalar nada. Você trabalha um caso no terminal, e essa metade é a que você instala aqui.

Ao fim desta página você tem uma sessão do pi que conhece o Fito. Trabalhar um caso é a próxima página — Comece seu primeiro caso.

Pré-requisitos

Dependência	Versão	Para que serve
Node.js	24 ou mais novo	Rodar o pacote de terminal do Fito
Um runtime pi.dev	Qualquer versão recente	O ambiente de agente em que o Fito roda
pi-subagents	0.68.0 ou mais novo	O transporte de trabalhadores em que o tutor e a avaliação se apoiam
git	Qualquer versão recente	O seu checkout do caso
gh, autenticado	Qualquer versão recente	Fazer o fork de um caso e abrir o pull request de envio
Um provedor de LLM configurado no pi	—	O tutor e a avaliação, que rodam na sua assinatura

O pacote de terminal conversa com o Fito hospedado, em https://fito.codes, a menos que você o aponte para outro servidor Fito. A última seção desta página diz como.

O provedor de LLM é seu, não do Fito

O servidor do Fito não guarda nenhuma chave de LLM e nunca faz uma chamada a modelo. Tudo o que o tutor e a avaliação custam, custam na sua conta de provedor. Veja Seus dados e privacidade.

Instalar o pi.dev e o pi-subagents

1. Instale o runtime do pi e confirme que ele responde:

   npm i -g @earendil-works/pi-coding-agent
   pi --version

2. Instale o pacote pi-subagents, que dá ao Fito o transporte de trabalhadores em que o tutor e a avaliação se apoiam:

   pi install npm:pi-subagents

   Ele é instalado sem versão de propósito — acompanha os próprios lançamentos. O Fito precisa da 0.68.0 ou mais nova, e avisa quando o pi inicia se a sua for mais antiga. O pi-subagents é de Nico Bailon, sob a licença MIT.

3. Autentique o gh com a conta do GitHub que você vai usar no Fito:

   gh auth login

Confirme este passo: o pi --version imprime uma versão, e o gh auth status nomeia a sua conta.

Configurar um provedor de LLM

O tutor e a avaliação chamam um modelo, e o pi faz essa chamada na sua conta. Configure um provedor antes de usar qualquer um dos dois. Instalar o Fito e carregá-lo numa sessão não exige provedor, então este passo também pode esperar.

Escolha um jeito:

• Uma assinatura. Inicie o pi, rode /login e selecione o seu provedor.
• Uma chave de API guardada pelo pi. Rode /login, selecione o seu provedor e cole a chave. O pi a guarda para as próximas sessões.
• Uma chave de API no seu ambiente. Exporte a variável do provedor antes de iniciar o pi — por exemplo ANTHROPIC_API_KEY, para a Anthropic.
• Só para uma sessão. Inicie o pi com --provider, --model e --api-key. Uma chave passada assim vence as outras três.

Os provedores que o pi aceita, e a variável que cada um lê, estão na página Providers da documentação do próprio pi.

Sair de uma instalação por clone

Pule esta seção se você nunca instalou o Fito a partir de um clone do repositório dele. Versões anteriores desta página o instalavam assim, a partir do tui/ do clone.

Uma instalação por clone e a instalação pelo npm não convivem. Com as duas, o pi carrega o Fito duas vezes e se recusa a iniciar, com Tool "fito_knowledge_fetch" conflicts with …. Então remova a instalação por clone antes de instalar pelo npm:

1. Para achar a instalação por clone e o caminho dela, rode pi list na pasta de onde você a instalou.
2. Remova-a. Troque INSTALL_PATH pelo caminho que o pi list mostra:

   • Para uma instalação feita com pi install -l, rode isto na mesma pasta:

     pi remove -l INSTALL_PATH

     Se o pi responder Project is not trusted, acrescente --approve.

   • Para qualquer outra instalação:

     pi remove INSTALL_PATH

Confirme que funcionou: rode pi list naquela pasta de novo, e o caminho sumiu.

Instalar o pacote do Fito

O pacote de terminal do Fito está no npm, como fito-tui. Para instalá-lo, rode:

pi install npm:fito-tui

O Fito passa então a carregar em toda sessão do pi, em qualquer pasta. Para desligá-lo sem removê-lo, rode pi config.

Conferir que pegou

Inicie uma sessão do pi em qualquer pasta. No início da sessão, a extensão de startup do Fito registra as suas seis ferramentas para a sessão. As personas trabalhadoras dele vêm do próprio pacote: o package.json do pacote nomeia a pasta agents/ dele, e o pi-subagents lê as personas ali. Nada é copiado para a sua pasta.

A conferência direta é um comando /fito-. Digite /fito- e a lista de completação deve oferecer os comandos do Fito; o /fito-login é o próximo que você quer.

Quando a sessão inicia, o Fito também confere três coisas, e mostra uma mensagem quando uma delas falha:

• O pi-subagents está faltando. O tutor e a avaliação alcançam o trabalhador deles por esse pacote, então nenhum dos dois funciona antes de você instalá-lo.
• O pi-subagents é mais antigo que a 0.68.0.
• O servidor do Fito recusa o seu pacote do Fito por ser antigo demais.

Cada mensagem nomeia o comando que a resolve. As três estão em Resolver problemas de instalação.

Atualizar o Fito

Quando sai uma versão nova do Fito, o pi avisa quando inicia. Para instalá-la, rode isto no seu shell e depois inicie o pi de novo:

pi update --extensions

Ele atualiza todo pacote que você instalou com o pi, o pi-subagents entre eles.

O pi não procura versão nova para uma instalação por clone, então uma instalação por clone nunca fica sabendo de uma. É mais um motivo para sair dela.

Apontar o Fito para outro servidor

Uma variável de ambiente, FITO_URL, move as duas metades do Fito. Quando ela não está definida, o pacote de terminal usa o Fito hospedado, em https://fito.codes. Defina-a com o endereço de outro Fito, e o pacote encontra o aplicativo web nesse endereço e o backend no mesmo endereço mais /api.

Uma instalação local do Fito serve as duas metades a partir de http://localhost:8000. Para usar uma, defina:

export FITO_URL=http://localhost:8000

O que vem a seguir

• Comece seu primeiro caso — o caminho inteiro, de ponta a ponta.
• Criar uma conta e entrar — você precisa de uma antes do login pelo terminal.
• Resolver problemas de instalação — quando algo acima não sair como escrito.