OpenCopilot

OpenCopilot

Open (formerly Squarelab / OpenChat) · Programação · Produtividade · Chatbot

OpenCopilot é um framework de código aberto que transforma as APIs do seu produto em um copiloto de IA. Você envia um arquivo OpenAPI e o usuário resolve tarefas escrevendo em linguagem natural.

Prévia da interface de OpenCopilot

Sobre OpenCopilot

About

O que é o OpenCopilot

OpenCopilot é um framework de copilotos de IA que roda na sua própria infraestrutura. Ele lê a definição da sua API, descobre qual endpoint resolve o pedido, preenche os parâmetros e devolve a resposta como mensagem de chat. A licença é MIT, então dá para usar dentro de um produto comercial sem pagar por assento.

O problema que ele ataca é específico: o usuário que não quer aprender a sua interface. A pessoa digita "abre um chamado sobre a exportação quebrada" e o copiloto escolhe o endpoint de criação de chamados, sugere um título e faz a chamada. Você mantém a API que já existe e coloca uma camada de linguagem natural em cima dela.

Os limites pesam tanto quanto os recursos. O repositório foi arquivado em março de 2025 e o README avisa que o projeto não recebe mais manutenção, ou seja, ninguém publica correção de segurança. APIs grandes precisam de transformadores JSON escritos à mão, e a instalação supõe Docker e alguém à vontade para ler logs.

Primeiros passos

  1. Clone o repositório e troque o marcador OPENAI_API_KEY no arquivo .env da pasta llm-server.
  2. Rode make install no Linux ou make install-arm em um Mac com Apple Silicon. O console fica em http://localhost:8888.
  3. Importe sua definição Swagger OpenAPI 3.0 e confira as ações que o OpenCopilot validou.
  4. Monte um fluxo de copiloto para as tarefas que encadeiam várias chamadas e cole o trecho do widget no seu app.

Informações do produto

Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de OpenCopilot.

Plano gratuitoSim
Planos pagosFree (MIT license, self-hosted)
PlataformaSelf-hosted web console (Docker), embeddable web chat widget
DesenvolvedorOpen (formerly Squarelab / OpenChat)
CategoriaProgramação · Produtividade · Chatbot
Data de lançamentoAug 2023
Última atualizaçãoMar 2025
Visitas ao siteN/A
Ranking global do siteN/A
Disponibilidade da APISim

Ideal para

Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.

Usuários

  • Desenvolvedores backend de SaaS
  • Fundadores solo com um MVP
  • Times com regras de residência de dados

Tarefas

  • Transformar uma API REST existente em assistente de chat
  • Testar ações em linguagem natural antes de refazer o produto
  • Reduzir chamados repetitivos de suporte

Cenários

  • Ferramentas internas de administração
  • Colocar um copiloto em um produto novo
  • Entender como agentes que chamam ferramentas funcionam

Principais recursos

Importação de especificações OpenAPI

Você envia um arquivo Swagger OpenAPI 3.0 e o OpenCopilot converte cada operação em uma ação que o modelo pode escolher. Antes disso ele valida o esquema, porque uma especificação malfeita gera chamadas erradas. A importação em lote é o caminho mais curto entre uma API documentada e um copiloto de IA funcionando.

Chamadas de API em linguagem natural

O copiloto lê o pedido, decide se precisa chamar a API, escolhe o endpoint e monta o corpo com o contexto. Peça "um chamado novo por causa de uma exportação quebrada" e o campo de título é preenchido sozinho. A resposta volta como texto legível, não como JSON cru.

Fluxos visuais para tarefas de várias etapas

Pedidos simples funcionam sem configuração. Os complicados não, e é para isso que existem os fluxos de copiloto. Você desenha a sequência em um editor visual e o modelo segue os seus passos em vez de adivinhar a ordem das chamadas.

Widget de chat incorporável

O widget vem no repositório e é montado com uma tag de script ou algumas linhas no frontend. É a parte que o usuário vê, e ela mantém o copiloto de API atrás do seu próprio login e das suas permissões.

Implantação auto-hospedada com Docker

Tudo roda com Docker Compose, com alvos de Make para instalar, migrar, ver logs, reiniciar e limpar por completo. Existem imagens ARM para notebooks com Apple Silicon. Suas chaves de API, os logs de conversa e os dados de clientes ficam em infraestrutura sua.

SDK de TypeScript e API do backend

O backend escuta na porta 8888 e expõe endpoints próprios, então você pode comandar o copiloto por script ou por outro serviço. Um SDK de TypeScript separado embrulha as mesmas chamadas para o frontend, e isso permite usar o copiloto de IA auto-hospedado fora do widget incluído.

Prós e contras

Prós

  • Licença MIT sem cobrança por assento ou por mensagem, então o custo não explode quando o uso cresce.
  • A importação de Swagger OpenAPI elimina quase todo o trabalho manual de descrever endpoints para o modelo.
  • A auto-hospedagem mantém as conversas e as credenciais dentro da sua rede.
  • Os fluxos de copiloto resolvem tarefas de várias etapas que um mapeamento simples de pedido para endpoint erra.
  • O repositório traz widget, painel e backend juntos, então você não escreve código de cola antes da demo.

Contras

  • O projeto está arquivado e sem manutenção: não haverá correção de segurança nem conserto quando uma dependência quebrar.
  • APIs grandes exigem transformadores JSON próprios, então a promessa de importar e sair funciona só em superfícies pequenas.
  • A instalação pede familiaridade com Docker, uma chave da OpenAI e conforto com a linha de comando.
  • A versão em nuvem que acompanhava o repositório acabou, então o suporte se resume a ler issues antigas.

Perguntas frequentes

O OpenCopilot coloca uma interface de chat na API de um produto que já existe. Ele lê uma definição OpenAPI, escolhe endpoints conforme o pedido do usuário e devolve o resultado como texto dentro de um widget de chat incorporável.