Repolode
Enviar
OlympiaAI

OlympiaAI/raix

Uma biblioteca Ruby para adicionar componentes discretos de LLM a apps Ruby, com chat completions, chamadas de ferramentas, cadeias de prompts e saída estruturada.

Ver no GitHub
Estrelas
329
Forks
30
Issues abertas
11
Último commit
há 2 meses

O que é?

Raix é uma gem Ruby para adicionar recursos de modelos de linguagem de grande porte a classes Ruby comuns. Você inclui módulos como ChatCompletion para obter um transcript e o método chat_completion; depois, chama modelos da OpenAI, Anthropic, Google Gemini e outros provedores por meio do OpenRouter. A biblioteca usa RubyLLM para se conectar aos provedores e funciona em apps que não usam Rails, desde que o ActiveSupport esteja disponível.

Além de completions básicos, Raix oferece chamadas automáticas de ferramentas (funções) com uma DSL declarativa para definir funções. Os resultados das ferramentas são enviados de volta ao modelo até que ele retorne uma resposta em texto. A biblioteca também inclui o módulo PromptDeclarations para executar cadeias de prompts em sequência, o módulo Predicate para perguntas com respostas sim/não/talvez, suporte experimental a clientes MCP para servidores remotos de ferramentas e a classe ResponseFormat para saídas em JSON Schema. Hooks permitem ajustar as requisições antes do envio, por exemplo, para escolher modelos por tenant ou remover dados pessoais.

O código foi extraído do Olympia, uma plataforma de equipe virtual de IA, e o autor documenta a abordagem de design em um livro relacionado sobre padrões de desenvolvimento de aplicações com IA.

Recursos principais

  • 01Chat completions com transcript que aceita hashes de mensagens abreviados ou no formato da OpenAI.
  • 02Chamadas automáticas de funções como ferramentas com uma DSL declarativa e um limite de chamadas configurável.
  • 03Cadeias de prompts via PromptDeclarations, com condições, callbacks e loops.
  • 04Modo JSON e formatos de resposta JSON Schema para saída estruturada.
  • 05Cache de prompts no estilo da Anthropic e hooks before_completion para modificar requisições.

Casos de uso

  • Adicionar uma etapa de resumo ou classificação com IA a um modelo Rails ou objeto de serviço.
  • Criar um pipeline de várias etapas em que cada chamada de LLM alimenta o prompt seguinte.
  • Permitir que um LLM chame métodos Ruby da sua aplicação para buscar dados ou acionar fluxos de trabalho.
  • Conectar um app Ruby a servidores remotos de ferramentas MCP para experimentação.

Início rápido

  1. 1

    Adicione a gem ao seu Gemfile

    bundle add raix
  2. 2

    Inclua Raix::ChatCompletion em uma classe Ruby e chame chat_completion

Antes de usar

  • O Raix 3.0 depende do RubyLLM e do OpenRouter, então você precisa de chaves de API de um provedor como OpenAI ou Anthropic.
  • Aplicações que não usam Rails precisam incluir o ActiveSupport como dependência.

Em coleções

Ferramentas, skills e plugins para Claude Code

Tópicos

#ruby#llm#openai#anthropic#tool-calling#prompt-engineering#openrouter

Perguntas frequentes

O que é raix?
Uma biblioteca Ruby para adicionar componentes discretos de LLM a apps Ruby, com chat completions, chamadas de ferramentas, cadeias de prompts e saída estruturada. Raix é uma gem Ruby para adicionar recursos de modelos de linguagem de grande porte a classes Ruby comuns. Você inclui módulos como ChatCompletion para obter um transcript e o método chat_completion; depois, chama modelos da OpenAI, Anthropic, Google Gemini e outros provedores por meio do OpenRouter. A biblioteca usa RubyLLM para se conectar aos provedores e funciona em apps que não usam Rails, desde que o ActiveSupport esteja disponível.
raix é gratuito? Qual é a licença?
raix é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
raix ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de raix foi em 22 de set. de 2026.
Para que posso usar raix?
Adicionar uma etapa de resumo ou classificação com IA a um modelo Rails ou objeto de serviço. Criar um pipeline de várias etapas em que cada chamada de LLM alimenta o prompt seguinte. Permitir que um LLM chame métodos Ruby da sua aplicação para buscar dados ou acionar fluxos de trabalho. Conectar um app Ruby a servidores remotos de ferramentas MCP para experimentação.
Como instalar raix?
Adicione a gem ao seu Gemfile: bundle add raix Inclua Raix::ChatCompletion em uma classe Ruby e chame chat_completion
Onde consigo raix?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/OlympiaAI/raix

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

Projetos relacionados