Repolode
Enviar
crmne

crmne/ruby_llm

Framework de IA para Ruby que permite criar recursos com LLMs — chat, ferramentas, agentes, embeddings e integração com Rails — usando uma única API.

Ver no GitHubSite
Estrelas
4,497
Forks
534
Issues abertas
27
Último commit
há 16 horas

O que é?

RubyLLM é um framework Ruby para criar recursos de IA em aplicações. Ele oferece uma API consistente para 23 provedores de modelos, incluindo OpenAI, Anthropic, Gemini, Ollama e OpenRouter, além de qualquer endpoint compatível com OpenAI. Assim, é possível alternar entre modelos hospedados e locais sem reescrever o código da aplicação.

Além de chat básico, o framework oferece chamadas de ferramentas, que permitem ao modelo chamar métodos Ruby, agentes reutilizáveis, saídas estruturadas definidas com schemas Ruby, streaming, geração de imagens e vídeos, transcrição, síntese de voz e OCR. Também inclui um sistema de avaliação que executa conjuntos de dados com RSpec, Minitest ou Rake, além de conexões com servidores MCP, cache de prompts, alternativas de fallback e acompanhamento de custos por tentativa.

Para aplicações Rails, o RubyLLM oferece persistência de conversas com Active Record, anexos com Active Storage, streaming com Hotwire e geradores que criam uma interface de chat funcional.

Recursos principais

  • 01API unificada para 23 provedores, incluindo modelos locais via Ollama e endpoints compatíveis com OpenAI.
  • 02Chamadas de ferramentas que disponibilizam métodos Ruby para o modelo, com aprovação humana opcional.
  • 03Agentes reutilizáveis e um loop de agente que pode ser conduzido passo a passo.
  • 04Saídas estruturadas com schemas Ruby, com respostas convertidas em objetos Ruby.
  • 05Avaliações executadas com Ruby, RSpec, Minitest ou Rake.
  • 06Integração com Rails, com persistência via Active Record, streaming com Hotwire e geradores.

Casos de uso

  • Adicionar a uma aplicação Rails um assistente de chat que salva o histórico das conversas.
  • Criar um agente que chama métodos Ruby internos para responder a perguntas ou executar ações.
  • Gerar embeddings e reordenar resultados de busca em um pipeline de recuperação de informações.
  • Testar respostas de LLMs com um conjunto de dados como parte de uma suíte RSpec ou Minitest existente.

Início rápido

  1. 1

    Instale a gem com o Bundler

    bundle add ruby_llm --version 2.1.1
  2. 2

    Configure uma chave de API do provedor no seu script

  3. 3

    Faça uma pergunta com uma linha de código

    RubyLLM.chat.ask "What's the best way to learn Ruby?"

Antes de usar

  • É necessária uma chave de API de pelo menos um provedor de modelos.
  • As avaliações e alguns recursos, como a execução de código, estão disponíveis apenas na branch main, não na versão estável.

Em coleções

Frameworks e apps de agentes de IA open source

Tópicos

#ruby#llm#rails#agents#tool-calling#embeddings#rag#structured-output#agent-framework#agentic-ai

Perguntas frequentes

O que é ruby_llm?
Framework de IA para Ruby que permite criar recursos com LLMs — chat, ferramentas, agentes, embeddings e integração com Rails — usando uma única API. RubyLLM é um framework Ruby para criar recursos de IA em aplicações. Ele oferece uma API consistente para 23 provedores de modelos, incluindo OpenAI, Anthropic, Gemini, Ollama e OpenRouter, além de qualquer endpoint compatível com OpenAI. Assim, é possível alternar entre modelos hospedados e locais sem reescrever o código da aplicação.
ruby_llm é gratuito? Qual é a licença?
ruby_llm é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ruby_llm ainda é mantido?
Manutenção ativa. O último commit de ruby_llm foi em 6 de nov. de 2026.
Para que posso usar ruby_llm?
Adicionar a uma aplicação Rails um assistente de chat que salva o histórico das conversas. Criar um agente que chama métodos Ruby internos para responder a perguntas ou executar ações. Gerar embeddings e reordenar resultados de busca em um pipeline de recuperação de informações. Testar respostas de LLMs com um conjunto de dados como parte de uma suíte RSpec ou Minitest existente.
Como instalar ruby_llm?
Instale a gem com o Bundler: bundle add ruby_llm --version 2.1.1 Configure uma chave de API do provedor no seu script Faça uma pergunta com uma linha de código: RubyLLM.chat.ask "What's the best way to learn Ruby?"
Onde consigo ruby_llm?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/crmne/ruby_llm

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

Projetos relacionados