GitHub 오픈소스 탐험

최근 AI 기술의 발전은 우리 일상에 큰 변화를 가져왔습니다. 특히 자연어 처리(NLP) 분야에서의 혁신은 다양한 비즈니스와 개인 프로젝트에서 AI를 활용할 수 있는 기회를 열어 주었습니다. 하지만 다양한 AI 공급자가 제공하는 클라이언트 라이브러리들은 각각 다른 API, 응답 형식, 그리고 사용 규칙을 가지고 있어 개발자들에게 혼란을 주곤 했습니다. 이러한 문제를 해결하기 위해 등장한 것이 바로 RubyLLM입니다. RubyLLM은 OpenAI, Anthropic, Gemini, Bedrock 등의 다양한 AI API를 하나의 통일된 인터페이스로 사용할 수 있도록 해주는 Ruby 라이브러리입니다.

RubyLLM의 특징

1. 통일된 API

RubyLLM은 여러 AI 제공자의 API를 하나의 아름다운 Ruby API로 통합합니다. 이로 인해 복잡해 보일 수 있는 다양한 API를 간단하게 사용할 수 있습니다. 예를 들어, OpenAI의 GPT, Anthropic의 Claude, 그리고 Ollama와 같은 로컬 모델을 모두 동일한 방법으로 접근할 수 있습니다.

2. 간편한 설치

RubyLLM을 시작하기 위해 필요한 것은 단 세 가지 의존성입니다: Faraday, Zeitwerk, Marcel. 이를 통해 복잡한 설치 과정 없이 손쉽게 라이브러리를 사용할 수 있습니다.

3. 다양한 기능

RubyLLM은 단순한 챗봇 개발에 그치지 않고, 이미지 및 비디오 분석, 오디오와 PDF 파일 처리, 그리고 임베딩 생성 등 다채로운 기능을 지원합니다. 이러한 기능들은 다음과 같은 코드로 간편하게 사용할 수 있습니다.

빠른 시작 가이드

설치 방법

먼저, RubyGems를 통해 ruby_llm gem을 설치합니다.

gem install ruby_llm

기본 사용법

RubyLLM의 기본적인 사용법을 살펴보겠습니다.

질문하기

가장 간단한 예로, AI에게 질문을 던져볼 수 있습니다.

require 'ruby_llm'

chat = RubyLLM.chat
response = chat.ask "루비를 배우는 가장 좋은 방법은 무엇인가요?"
puts response.content

파일 분석

다양한 파일을 분석할 수도 있습니다. 이미지, 비디오, 오디오 파일을 AI에게 입력으로 줄 수 있습니다.

chat.ask "이 이미지에 무엇이 있나요?", with: "ruby_conf.jpg"

# 비디오 분석
chat.ask "이 비디오에서 무슨 일이 일어났나요?", with: "video.mp4"

# 오디오 파일 요약
chat.ask "이 회의의 내용을 설명해 주세요", with: "meeting.wav"

스트리밍 응답

AI의 응답을 실시간으로 스트리밍 받을 수도 있습니다.

chat.ask "루비에 대한 이야기를 해 주세요" do |chunk|
  print chunk.content
end

이미지 생성 및 임베딩

AI에게 이미지를 생성하거나 텍스트를 임베딩할 수도 있습니다.

# 이미지 생성
RubyLLM.paint "산 위의 석양을 수채화 스타일로 그려줘"

# 임베딩 생성
embedding = RubyLLM.embed "루비는 우아하고 표현력이 뛰어나다"

오디오 텍스트 변환

회의 녹음 파일을 텍스트로 변환할 수 있습니다.

transcription = RubyLLM.transcribe "meeting.wav"
puts transcription

도구 사용

직접 정의한 도구를 AI에게 제공할 수 있습니다. 예를 들어, 날씨를 가져오는 도구를 만들 수 있습니다.

class Weather < RubyLLM::Tool
  description "현재 날씨를 가져옵니다."
  param :latitude
  param :longitude

  def execute(latitude:, longitude:)
    url = "https://api.open-meteo.com/v1/forecast?latitude=#{latitude}&longitude=#{longitude}&current=temperature_2m,wind_speed_10m"
    JSON.parse(Faraday.get(url).body)
  end
end

chat.with_tool(Weather).ask "베를린의 날씨는 어떤가요?"

에이전트 정의

AI 에이전트를 정의하고 도구를 사용하여 질문할 수도 있습니다.

class WeatherAssistant < RubyLLM::Agent
  model "gpt-5-nano"
  instructions "간결하게 대답하고 항상 날씨 도구를 사용하세요."
  tools Weather
end

WeatherAssistant.new.ask "베를린의 날씨는 어떤가요?"

구조화된 출력

AI의 응답을 구조화된 형식으로 받을 수 있는 스키마를 정의할 수도 있습니다.

class ProductSchema < RubyLLM::Schema
  string :name
  number :price
  array :features do
    string
  end
end

response = chat.with_schema(ProductSchema).ask "이 제품을 분석해 주세요", with: "product.txt"

활용 시나리오

RubyLLM은 다양한 시나리오에서 활용될 수 있습니다. 예를 들어, 고객 지원 챗봇을 구축하거나, 자동화된 문서 요약 및 분석 도구, 이미지 분석 앱, 오디오 녹음 텍스트 변환 어플리케이션 등 여러가지 용도로 활용 가능합니다. 각종 비즈니스 프로세스를 자동화하고, 시간을 절약하며, 생산성을 높이는 데 큰 도움이 될 것입니다.

유사 도구와 비교

RubyLLM은 여러 AI API를 통합하여 사용할 수 있는 장점이 있습니다. 비슷한 도구로는 OpenAI의 openai-ruby gem이나 Google의 google-api-client 라이브러리가 있지만, 각각의 API에 맞춰져 있어 통합 사용이 어렵습니다. 반면 RubyLLM은 이러한 복잡성을 없애주어 개발자들이 더 쉽게 AI 기능을 활용할 수 있게 해줍니다.

이미지 분석