RubyLLM: 모든 주요 AI 제공업체를 위한 하나의 Ruby 프레임워크

RubyLLM 1.16.0은 Ruby 프레임워크로, OpenAI, xAI, Anthropic, Gemini, VertexAI, Bedrock, DeepSeek, Mistral, Ollama, OpenRouter, Perplexity, GPUStack 등 주요 AI 제공업체와 OpenAI 호환 API를 위한 통합 인터페이스를 제공합니다. 채팅, 비전, 오디오, 문서, 이미지 생성, 임베딩, 콘텐츠 검열, 툴, 에이전트, 구조화된 출력, 스트리밍, Rails 통합을 지원합니다.

빠른 시작

Gemfile에 gem 'ruby_llm'을 추가한 후 bundle install을 실행하세요.

API 키를 설정합니다:

RubyLLM.configure do |config|
  config.openai_api_key = ENV['OPENAI_API_KEY']
end

주요 기능

• 채팅: RubyLLM.chat.ask('질문')
• 비전: 이미지와 영상 분석 — chat.ask('설명해 줘', with: 'photo.jpg')
• 오디오: 음성 텍스트 변환 및 이해 — RubyLLM.transcribe('meeting.wav')
• 문서: PDF, CSV, JSON 등 모든 파일 형식에서 데이터 추출
• 이미지 생성: RubyLLM.paint('프롬프트')
• 임베딩: RubyLLM.embed('텍스트')
• 콘텐츠 검열: RubyLLM.moderate('텍스트')
• 툴: RubyLLM::Tool을 상속받아 AI가 Ruby 메서드를 호출하도록 설정
• 에이전트: RubyLLM::Agent를 사용한 재사용 가능한 어시스턴트
• 구조화된 출력: RubyLLM::Schema로 JSON 스키마 정의
• 스트리밍: 블록을 사용한 실시간 응답
• Rails: acts_as_chat로 ActiveRecord 통합, 선택적 채팅 UI
• 비동기: Fiber 기반 동시성
• 모델 레지스트리: 800개 이상 모델, 기능 감지 및 가격 정보

코드 예제

비전 채팅:

chat = RubyLLM.chat
chat.ask('이 이미지에는 무엇이 있나요?', with: 'ruby_conf.jpg')
chat.ask('이 문서를 요약해 주세요', with: 'contract.pdf')

툴 사용:

class Weather < RubyLLM::Tool
  desc '현재 날씨를 가져옵니다'
  def execute(latitude:, longitude:)
    JSON.parse(Faraday.get('https://api.open-meteo.com/...').body)
  end
end
chat.with_tool(Weather).ask('베를린의 날씨는 어떠세요?')

구조화된 출력:

class ProductSchema < RubyLLM::Schema
  string :name
  number :price
  array :features do
    string
  end
end
response = chat.with_schema(ProductSchema).ask('분석', with: 'product.txt')

Rails 통합

bin/rails generate ruby_llm:install
bin/rails db:migrate
bin/rails generate ruby_llm:chat_ui

acts_as_chat로 Chat 모델을 생성한 후 /chats에 접속하면 바로 사용할 수 있는 UI가 제공됩니다.

RubyLLM의 의존성은 Faraday, Zeitwerk, Marcel 세 가지뿐입니다.