Repolode
BoxcarsAI

BoxcarsAI/boxcars

Um framework Ruby para criar aplicações com LLMs usando ferramentas, agentes e engines compatíveis com vários provedores.

Estrelas
462
Forks
41
Issues abertas
7
Último commit
há 24 dias

O que é?

Boxcars é um framework Ruby para criar sistemas com LLMs, voltado especialmente para equipes que trabalham com Ruby e Rails. A lógica de domínio é encapsulada em objetos Boxcar, ferramentas de finalidade única para busca, cálculos, consultas SQL ou ActiveRecord e chamadas de API. Um Train coordena um conjunto de Boxcars com um Engine para dividir um problema em etapas, seja usando o ReAct textual legado (ZeroShot), seja com chamadas nativas de ferramentas do provedor (ToolTrain).

O framework oferece suporte a vários provedores de LLM por meio de padrões compartilhados de engine, incluindo OpenAI, Anthropic, Groq, Gemini, Ollama e Perplexity. Também oferece saída validada por JSON Schema, integração com vector stores e conexões com servidores MCP via stdio, que combinam ferramentas MCP externas com ferramentas locais. O StationAgent, de nível mais alto, adiciona callbacks de ciclo de vida, aninhamento de agentes, transferências de controle e transmissão de eventos.

Os boxcars de SQL e ActiveRecord são somente leitura por padrão e rejeitam operações de escrita, a menos que sejam explicitamente habilitadas. As gems opcionais de provedores só são carregadas quando usadas, e o projeto exige Ruby 3.3 ou mais recente.

Recursos principais

  • 01Encapsula a lógica de domínio em ferramentas Boxcar reutilizáveis para SQL, ActiveRecord, buscas e chamadas de API.
  • 02Oferece orquestração com ReAct textual via ZeroShot e chamadas nativas de ferramentas via ToolTrain.
  • 03Oferece suporte a OpenAI, Anthropic, Groq, Gemini, Ollama e outros provedores por meio de engines compartilhadas.
  • 04Valida saídas estruturadas com JSON Schema usando JSONEngineBoxcar.
  • 05Conecta-se a servidores MCP via stdio e combina as ferramentas deles com Boxcars locais.
  • 06Oferece o StationAgent, com callbacks, transferências de controle e transmissão de eventos.

Casos de uso

  • Criar copilotos internos que consultam documentos e dados de ActiveRecord ou SQL.
  • Criar bots de operações que chamam APIs definidas com Swagger para executar ações em várias etapas.
  • Combinar busca vetorial com chamadas subsequentes a ferramentas em assistentes que priorizam a recuperação de informações.
  • Combinar ferramentas Ruby personalizadas com ferramentas descobertas em servidores MCP.

Início rápido

  1. 1

    Adicione a gem ao Gemfile (requer Ruby 3.3 ou superior)

    gem 'boxcars'
  2. 2

    Instale as dependências com Bundler

    bundle install
  3. 3

    Ou instale a gem diretamente

    gem install boxcars

Antes de usar

  • Requer Ruby 3.3 ou superior.
  • Muitos recursos exigem a adição separada de gems de provedores opcionais e chaves de API.

Em coleções

Tópicos

Perguntas frequentes

O que é boxcars?
Um framework Ruby para criar aplicações com LLMs usando ferramentas, agentes e engines compatíveis com vários provedores. Boxcars é um framework Ruby para criar sistemas com LLMs, voltado especialmente para equipes que trabalham com Ruby e Rails. A lógica de domínio é encapsulada em objetos Boxcar, ferramentas de finalidade única para busca, cálculos, consultas SQL ou ActiveRecord e chamadas de API. Um Train coordena um conjunto de Boxcars com um Engine para dividir um problema em etapas, seja usando o ReAct textual legado (ZeroShot), seja com chamadas nativas de ferramentas do provedor (ToolTrain).
boxcars é gratuito? Qual é a licença?
boxcars é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
boxcars ainda é mantido?
Manutenção ativa. O último commit de boxcars foi em 13 de out. de 2026.
Para que posso usar boxcars?
Criar copilotos internos que consultam documentos e dados de ActiveRecord ou SQL. Criar bots de operações que chamam APIs definidas com Swagger para executar ações em várias etapas. Combinar busca vetorial com chamadas subsequentes a ferramentas em assistentes que priorizam a recuperação de informações. Combinar ferramentas Ruby personalizadas com ferramentas descobertas em servidores MCP.
Como instalar boxcars?
Adicione a gem ao Gemfile (requer Ruby 3.3 ou superior): gem 'boxcars' Instale as dependências com Bundler: bundle install Ou instale a gem diretamente: gem install boxcars
Onde consigo boxcars?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/BoxcarsAI/boxcars

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados