Skills

Curie: a plataforma de código aberto e auto-hospedada que transforma agentes de código em colegas

Ideal para equipes de desenvolvimento que delegam issues do GitHub a um colega de codificação com IA e recebem um PR/MR aguardando revisão; é preciso trazer o próprio ambiente Docker/Kubernetes e uma credencial de modelo Anthropic ou OpenRouter.

Official source · Curie

Install

curl -fsSL https://raw.githubusercontent.com/curie-eng/curie/main/get-curie.sh | bash

Para quem é

  • Para equipes de desenvolvimento que querem colaboração de IA na própria infraestrutura: a Curie é uma plataforma de código aberto que pode ser auto-hospedada, roda na sua infraestrutura e transforma agentes de código em colegas aos quais você pode atribuir tarefas e validar as entregas.
  • O cenário central é "delegar uma issue do GitHub e receber uma implementação pronta para revisão": a Curie cuida da implementação e da revisão da issue e devolve um pull request ou merge request aguardando a aceitação do time.
  • Também serve para colaboração em operações de Kubernetes: verificações de Kubernetes somente leitura executam imediatamente e operações de mutação configuradas pedem aprovação humana — bom para entregar rotinas de baixo risco como inspeções e diagnósticos.
  • Para equipes que querem manter a aprovação em mãos humanas: operações de mutação configuradas exigem uma nova aprovação humana a cada vez, e você define quais ações precisam de aprovação prévia.
  • Equipes que já mantêm o próprio agente de código podem adotá-lo com o comando oficial curie init --adopt ./my-existing-agent.
  • Quando não é adequado: uma máquina que não consiga executar Docker, ou não conseguir obter uma credencial de modelo da Anthropic ou da OpenRouter — cada pré-requisito da lista oficial é indispensável.

Sua primeira tentativa em 3 minutos

Pré-requisitos: uma máquina com o Docker já em execução, com kind, kubectl e Helm instalados, além de uma credencial de modelo da Anthropic ou da OpenRouter. Se faltar qualquer um desses itens, não dá para começar seguindo as instruções oficiais.

Execute o script de instalação oficial no terminal:

curl -fsSL https://raw.githubusercontent.com/curie-eng/curie/main/get-curie.sh | bash

O script vem do branch main do repositório da Curie; um comando em pipe executa um script remoto diretamente com as permissões do seu usuário — se preferir, baixe antes e revise o conteúdo antes de executar.

Para a primeira tentativa, escolha o caminho de baixo risco: pegue uma issue do repositório com descrição clara e escopo pequeno e delegue à Curie a implementação e a revisão. Ao concluir, ela devolve um pull request ou merge request aguardando a aceitação do seu time. O sinal de sucesso é claro: você recebe na sua plataforma de hospedagem de código o PR/MR gerado e pode revisar as alterações uma a uma.

Como cadastrar a credencial do modelo após a instalação e como vincular sua conta de hospedagem de código não são explicados passo a passo nas instruções oficiais; guie-se pelas mensagens do script e pela documentação do repositório.

Casos de uso

Caso 1: transformar uma issue em um PR aguardando revisão. Cenário: uma issue de implementação com escopo bem definido está acumulada no repositório do time e ninguém consegue tratá-la a tempo. Como iniciar: delegue a issue à Curie, o que corresponde ao fluxo oficial de "delegar a issue para implementação e revisão". Processo e resultado: ao concluir, ela devolve um PR/MR e você revisa as alterações uma a uma na sua própria plataforma de hospedagem; o ponto final verificável é obter um PR/MR aguardando a aceitação do time.

Caso 2: inspeção de Kubernetes somente leitura. Cenário: você precisa conhecer o estado atual do cluster, mas não quer passar por todo o ciclo de aprovação de mudanças para uma verificação de status rotineira. Como iniciar: peça à Curie uma verificação de Kubernetes somente leitura, que usa justamente as ferramentas de Kubernetes somente leitura descritas oficialmente. Processo e resultado: operações somente leitura executam imediatamente, sem aprovação extra; se em seguida você pedir uma operação de mutação configurada, ela pedirá antes uma nova aprovação humana e só então seguirá. Mantenha a primeira inspeção no escopo somente leitura e não haverá espera de aprovação; para observar a etapa de aprovação, adicione um pedido de mutação e o aviso de aprovação aparecerá. Quais ferramentas somente leitura são oferecidas e como chamá-las não está listado item a item nas notas oficiais.

Limites de uso

  • Pré-requisitos de ambiente: Docker em execução, kind, kubectl e Helm disponíveis, além de uma credencial de modelo da Anthropic ou da OpenRouter; os requisitos de sistema operacional e arquitetura de hardware não são informados pela fonte oficial.
  • Efeitos colaterais e pontos de confirmação: ferramentas de Kubernetes somente leitura executam imediatamente; operações de mutação configuradas pedem uma nova aprovação humana a cada vez; o resultado de uma implementação delegada é um PR/MR aguardando a aceitação do time. O que o script de instalação cria na sua máquina e quais diretórios ocupa não é detalhado oficialmente — você pode revisar o conteúdo do script antes de executá-lo.
  • Onde roda: uma plataforma auto-hospedada, que executa na sua própria infraestrutura.
  • Adotar um agente existente: o comando oficial curie init --adopt ./my-existing-agent é fornecido; a documentação oficial não especifica o que o comando preserva do agente existente. A inicialização e a configuração além disso não são detalhadas nas instruções oficiais.
  • O que verificar no repositório antes de agir: os passos de configuração da credencial após a instalação, como conectar sua conta de hospedagem de código, a lista completa de ferramentas somente leitura disponíveis e de operações de mutação configuráveis, se há suporte a provedores de modelo além desses dois, e a lista exata de agentes de código compatíveis. Confirme item a item com a documentação do repositório antes de começar.