polylingo_chat 0.1.0

data/lib/polylingo_chat/translator/anthropic_client.rb

@@ -0,0 +1,85 @@
+require 'faraday'
+require 'json'
+require 'digest'
+
+module PolylingoChat
+  module Translator
+    class AnthropicClient < Base
+      class << self
+        def detect_language(text)
+          return 'unknown' if text.nil? || text.strip.empty?
+          prompt = "Detect language for the following text and return the ISO 639-1 code only:\n\n#{text}"
+          resp = anthropic_message(prompt, system: 'You are a language detection assistant. Return only the lowercase ISO 639-1 code.')
+          code = resp.to_s.strip[0,2]&.downcase
+          code || 'unknown'
+        end
+
+        def translate(text:, from: nil, to:, context: nil)
+          raise PolylingoChat::Error, 'target language required' if to.nil? || to.to_s.strip.empty?
+          return '' if text.nil?
+
+          # caching
+          cache_key = "polylingo_chat:#{Digest::SHA1.hexdigest([text, from, to, context].join(':'))}"
+          if (cache = PolylingoChat.config.cache_store)
+            cached = cache.get(cache_key) rescue nil
+            return JSON.parse(cached)['translated'] if cached
+          end
+
+          prompt = build_prompt(text: text, from: from, to: to, context: context)
+          translated = anthropic_message(prompt, system: 'You are a translation assistant. Return only the translated text with no additional commentary.')
+
+          if (cache = PolylingoChat.config.cache_store)
+            begin
+              cache.set(cache_key, { translated: translated }.to_json)
+            rescue => e
+              # ignore cache failures
+            end
+          end
+
+          translated
+        end
+
+        private
+
+        def build_prompt(text:, from:, to:, context:)
+          ctx = context ? "CONTEXT:\n#{context}\n\n" : ''
+          src = from ? "(source language: #{from})" : '(source language unknown)'
+          "Translate the following text to #{to}. #{src}\n\n#{ctx}TEXT:\n#{text}"
+        end
+
+        def anthropic_message(prompt, system: nil)
+          api_key = PolylingoChat.config.api_key
+          raise PolylingoChat::Error, 'API key not configured' unless api_key
+
+          conn = Faraday.new(url: 'https://api.anthropic.com', request: { timeout: PolylingoChat.config.timeout, open_timeout: 5 }) do |f|
+            f.request :json
+            f.adapter Faraday.default_adapter
+          end
+
+          body = {
+            model: PolylingoChat.config.model || 'claude-3-5-sonnet-20241022',
+            max_tokens: 1024,
+            messages: [
+              { role: 'user', content: prompt }
+            ]
+          }
+          body[:system] = system if system
+
+          res = conn.post('/v1/messages') do |r|
+            r.headers['x-api-key'] = api_key
+            r.headers['anthropic-version'] = '2023-06-01'
+            r.headers['Content-Type'] = 'application/json'
+            r.body = body.to_json
+          end
+
+          if res.status >= 400
+            raise PolylingoChat::Error, "Anthropic API error: #{res.status} - #{res.body}"
+          end
+
+          parsed = JSON.parse(res.body)
+          parsed.dig('content', 0, 'text') || ''
+        end
+      end
+    end
+  end
+end

data/lib/polylingo_chat/translator/base.rb

@@ -0,0 +1,13 @@
+module PolylingoChat
+  module Translator
+    class Base
+      def self.detect_language(text)
+        raise NotImplementedError
+      end
+
+      def self.translate(text:, from:, to:, context:)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/polylingo_chat/translator/gemini_client.rb

@@ -0,0 +1,88 @@
+require 'faraday'
+require 'json'
+require 'digest'
+
+module PolylingoChat
+  module Translator
+    class GeminiClient < Base
+      class << self
+        def detect_language(text)
+          return 'unknown' if text.nil? || text.strip.empty?
+          prompt = "Detect language for the following text and return the ISO 639-1 code only:\n\n#{text}"
+          resp = gemini_generate(prompt, system: 'You are a language detection assistant. Return only the lowercase ISO 639-1 code.')
+          code = resp.to_s.strip[0,2]&.downcase
+          code || 'unknown'
+        end
+
+        def translate(text:, from: nil, to:, context: nil)
+          raise PolylingoChat::Error, 'target language required' if to.nil? || to.to_s.strip.empty?
+          return '' if text.nil?
+
+          # caching
+          cache_key = "polylingo_chat:#{Digest::SHA1.hexdigest([text, from, to, context].join(':'))}"
+          if (cache = PolylingoChat.config.cache_store)
+            cached = cache.get(cache_key) rescue nil
+            return JSON.parse(cached)['translated'] if cached
+          end
+
+          prompt = build_prompt(text: text, from: from, to: to, context: context)
+          translated = gemini_generate(prompt, system: 'You are a translation assistant. Return only the translated text with no additional commentary.')
+
+          if (cache = PolylingoChat.config.cache_store)
+            begin
+              cache.set(cache_key, { translated: translated }.to_json)
+            rescue => e
+              # ignore cache failures
+            end
+          end
+
+          translated
+        end
+
+        private
+
+        def build_prompt(text:, from:, to:, context:)
+          ctx = context ? "CONTEXT:\n#{context}\n\n" : ''
+          src = from ? "(source language: #{from})" : '(source language unknown)'
+          "Translate the following text to #{to}. #{src}\n\n#{ctx}TEXT:\n#{text}"
+        end
+
+        def gemini_generate(prompt, system: nil)
+          api_key = PolylingoChat.config.api_key
+          raise PolylingoChat::Error, 'API key not configured' unless api_key
+
+          model = PolylingoChat.config.model || 'gemini-1.5-flash'
+
+          conn = Faraday.new(url: 'https://generativelanguage.googleapis.com', request: { timeout: PolylingoChat.config.timeout, open_timeout: 5 }) do |f|
+            f.request :json
+            f.adapter Faraday.default_adapter
+          end
+
+          contents = []
+          contents << { role: 'user', parts: [{ text: system }] } if system
+          contents << { role: 'user', parts: [{ text: prompt }] }
+
+          body = {
+            contents: contents,
+            generationConfig: {
+              temperature: 0.0,
+              maxOutputTokens: 1024
+            }
+          }
+
+          res = conn.post("/v1beta/models/#{model}:generateContent?key=#{api_key}") do |r|
+            r.headers['Content-Type'] = 'application/json'
+            r.body = body.to_json
+          end
+
+          if res.status >= 400
+            raise PolylingoChat::Error, "Gemini API error: #{res.status} - #{res.body}"
+          end
+
+          parsed = JSON.parse(res.body)
+          parsed.dig('candidates', 0, 'content', 'parts', 0, 'text') || ''
+        end
+      end
+    end
+  end
+end

data/lib/polylingo_chat/translator/openai_client.rb

@@ -0,0 +1,92 @@
+require 'faraday'
+require 'json'
+require 'digest'
+
+module PolylingoChat
+  module Translator
+    class OpenAIClient < Base
+      class << self
+        def detect_language(text)
+          return 'unknown' if text.nil? || text.strip.empty?
+          prompt = "Detect language for the following text and return the ISO 639-1 code only:
+
+#{text}"
+          resp = openai_chat(prompt, system: 'You are a language detection assistant. Return only the lowercase ISO 639-1 code.')
+          code = resp.to_s.strip[0,2]&.downcase
+          code || 'unknown'
+        end
+
+        def translate(text:, from: nil, to:, context: nil)
+          raise PolylingoChat::Error, 'target language required' if to.nil? || to.to_s.strip.empty?
+          return '' if text.nil?
+
+          # caching
+          cache_key = "polylingo_chat:#{Digest::SHA1.hexdigest([text, from, to, context].join(':'))}"
+          if (cache = PolylingoChat.config.cache_store)
+            cached = cache.get(cache_key) rescue nil
+            return JSON.parse(cached)['translated'] if cached
+          end
+
+          prompt = build_prompt(text: text, from: from, to: to, context: context)
+          translated = openai_chat(prompt, system: 'You are a translation assistant. Return only the translated text with no additional commentary.')
+
+          if (cache = PolylingoChat.config.cache_store)
+            begin
+              cache.set(cache_key, { translated: translated }.to_json)
+            rescue => e
+              # ignore cache failures
+            end
+          end
+
+          translated
+        end
+
+        private
+
+        def build_prompt(text:, from:, to:, context:)
+          ctx = context ? "CONTEXT:
+#{context}
+
+" : ''
+          src = from ? "(source language: #{from})" : '(source language unknown)'
+          "Translate the following text to #{to}. #{src}
+
+#{ctx}TEXT:
+#{text}"
+        end
+
+        def openai_chat(prompt, system: nil)
+          api_key = PolylingoChat.config.api_key
+          raise PolylingoChat::Error, 'API key not configured' unless api_key
+
+          conn = Faraday.new(url: 'https://api.openai.com', request: { timeout: PolylingoChat.config.timeout, open_timeout: 5 }) do |f|
+            f.request :json
+            f.adapter Faraday.default_adapter
+          end
+
+          body = {
+            model: PolylingoChat.config.model,
+            messages: [
+              { role: 'system', content: system || 'You are a helpful assistant.' },
+              { role: 'user', content: prompt }
+            ],
+            temperature: 0.0
+          }
+
+          res = conn.post('/v1/chat/completions') do |r|
+            r.headers['Authorization'] = "Bearer #{api_key}"
+            r.headers['Content-Type'] = 'application/json'
+            r.body = body.to_json
+          end
+
+          if res.status >= 400
+            raise PolylingoChat::Error, "OpenAI API error: #{res.status} - #{res.body}"
+          end
+
+          parsed = JSON.parse(res.body)
+          parsed.dig('choices', 0, 'message', 'content') || ''
+        end
+      end
+    end
+  end
+end

data/lib/polylingo_chat/translator.rb

@@ -0,0 +1,40 @@
+require_relative 'translator/base'
+require_relative 'translator/openai_client'
+require_relative 'translator/anthropic_client'
+require_relative 'translator/gemini_client'
+
+module PolylingoChat
+  module Translator
+    class << self
+      def detect_language(text)
+        provider_client.detect_language(text)
+      end
+
+      def translate(text:, from: nil, to:, context: nil)
+        provider_client.translate(text: text, from: from, to: to, context: context)
+      end
+
+      def provider_client
+        @provider_client ||= configure_provider
+      end
+
+      def configure_provider
+        case PolylingoChat.config.provider
+        when :openai
+          PolylingoChat::Translator::OpenAIClient
+        when :anthropic
+          PolylingoChat::Translator::AnthropicClient
+        when :gemini
+          PolylingoChat::Translator::GeminiClient
+        else
+          PolylingoChat::Translator::OpenAIClient
+        end
+      end
+
+      def reset_provider!
+        @provider_client = nil
+        configure_provider
+      end
+    end
+  end
+end

data/lib/polylingo_chat/version.rb

@@ -0,0 +1,3 @@
+module PolylingoChat
+  VERSION = '0.1.0'
+end

data/lib/polylingo_chat.rb

@@ -0,0 +1,11 @@
+require 'polylingo_chat/version'
+require 'polylingo_chat/engine'
+require 'polylingo_chat/config'
+require 'polylingo_chat/railtie'
+require 'polylingo_chat/translator'
+require 'polylingo_chat/translate_job'
+require 'polylingo_chat/realtime'
+
+module PolylingoChat
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: polylingo_chat
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Shoaib Malik
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-11-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email:
+- shoaib2109@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/generators/polylingo_chat/install/install_generator.rb
+- lib/generators/polylingo_chat/install/templates/README
+- lib/generators/polylingo_chat/install/templates/channels/application_cable/channel.rb
+- lib/generators/polylingo_chat/install/templates/channels/application_cable/connection.rb
+- lib/generators/polylingo_chat/install/templates/channels/polylingo_chat_channel.rb
+- lib/generators/polylingo_chat/install/templates/create_conversations.rb
+- lib/generators/polylingo_chat/install/templates/create_messages.rb
+- lib/generators/polylingo_chat/install/templates/create_participants.rb
+- lib/generators/polylingo_chat/install/templates/initializer.rb
+- lib/generators/polylingo_chat/install/templates/javascript/channels/consumer.js
+- lib/generators/polylingo_chat/install/templates/javascript/channels/index.js
+- lib/generators/polylingo_chat/install/templates/javascript/chat.js
+- lib/generators/polylingo_chat/install/templates/models/conversation.rb
+- lib/generators/polylingo_chat/install/templates/models/message.rb
+- lib/generators/polylingo_chat/install/templates/models/participant.rb
+- lib/generators/polylingo_chat/install_generator.rb
+- lib/generators/polylingo_chat/templates/INSTALL_README.md
+- lib/generators/polylingo_chat/templates/chat_channel_example.js
+- lib/generators/polylingo_chat/templates/create_polyglot_conversations.rb
+- lib/generators/polylingo_chat/templates/create_polyglot_messages.rb
+- lib/generators/polylingo_chat/templates/create_polyglot_participants.rb
+- lib/generators/polylingo_chat/templates/models/conversation.rb
+- lib/generators/polylingo_chat/templates/models/message.rb
+- lib/generators/polylingo_chat/templates/models/participant.rb
+- lib/generators/polylingo_chat/templates/polyglot.rb
+- lib/generators/polylingo_chat/templates/polylingo_chat_channel.rb
+- lib/polylingo_chat.rb
+- lib/polylingo_chat/config.rb
+- lib/polylingo_chat/engine.rb
+- lib/polylingo_chat/railtie.rb
+- lib/polylingo_chat/realtime.rb
+- lib/polylingo_chat/translate_job.rb
+- lib/polylingo_chat/translator.rb
+- lib/polylingo_chat/translator/anthropic_client.rb
+- lib/polylingo_chat/translator/base.rb
+- lib/polylingo_chat/translator/gemini_client.rb
+- lib/polylingo_chat/translator/openai_client.rb
+- lib/polylingo_chat/version.rb
+homepage: https://github.com/AdwareTechnologies/polylingo_chat
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Realtime chat with automatic AI translation for Ruby/Rails apps
+test_files: []