diff --git a/sdk/ruby/lib/telecom_sdk.rb b/sdk/ruby/lib/telecom_sdk.rb
new file mode 100644
index 0000000..d13be88
--- /dev/null
+++ b/sdk/ruby/lib/telecom_sdk.rb
@@ -0,0 +1,222 @@
+require "httparty"
+require "json"
+require "websocket-client-simple"
+require "uri"
+
+module TelecomSDK
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class APIError < Error; end
+  class NetworkError < Error; end
+  class ValidationError < Error; end
+  class RateLimitError < Error; end
+  class ServerError < Error; end
+
+  class Client
+    include HTTParty
+    
+    attr_reader :config
+    
+    def initialize(config = {})
+      @config = Config.new(config)
+      self.class.base_uri @config.api_url
+      self.class.default_options.update(
+        timeout: @config.timeout,
+        headers: {
+          "User-Agent" => "Telecom-Ruby-SDK/1.0.0",
+          "Content-Type" => "application/json"
+        }
+      )
+      
+      if @config.api_key
+        self.class.default_options[:headers]["Authorization"] = "Bearer #{@config.api_key}"
+      end
+    end
+    
+    # Subscriber Management
+    
+    def get_subscriber(id)
+      response = self.class.get("/v1/subscribers/#{id}")
+      handle_response(response)
+      Subscriber.new(response.parsed_response)
+    end
+    
+    def list_subscribers(page: 1, page_size: 50, status: nil)
+      params = { page: page, page_size: page_size }
+      params[:status] = status if status
+      
+      response = self.class.get("/v1/subscribers", query: params)
+      handle_response(response)
+      SubscriberList.new(response.parsed_response)
+    end
+    
+    def create_subscriber(request)
+      response = self.class.post("/v1/subscribers", body: request.to_json)
+      handle_response(response)
+      Subscriber.new(response.parsed_response)
+    end
+    
+    def update_subscriber(id, request)
+      response = self.class.put("/v1/subscribers/#{id}", body: request.to_json)
+      handle_response(response)
+      Subscriber.new(response.parsed_response)
+    end
+    
+    def suspend_subscriber(id)
+      response = self.class.post("/v1/subscribers/#{id}/suspend")
+      handle_response(response)
+      Subscriber.new(response.parsed_response)
+    end
+    
+    def activate_subscriber(id)
+      response = self.class.post("/v1/subscribers/#{id}/activate")
+      handle_response(response)
+      Subscriber.new(response.parsed_response)
+    end
+    
+    def terminate_subscriber(id)
+      response = self.class.delete("/v1/subscribers/#{id}")
+      handle_response(response)
+      response.parsed_response["success"]
+    end
+    
+    # Usage Management
+    
+    def get_usage_stats(subscriber_id, start_date, end_date)
+      params = {
+        start_date: start_date.iso8601,
+        end_date: end_date.iso8601
+      }
+      
+      response = self.class.get("/v1/subscribers/#{subscriber_id}/usage", query: params)
+      handle_response(response)
+      UsageStats.new(response.parsed_response)
+    end
+    
+    def list_usage_events(subscriber_id: nil, usage_type: nil, start_date: nil, end_date: nil, page: 1, page_size: 50)
+      params = { page: page, page_size: page_size }
+      params[:subscriber_id] = subscriber_id if subscriber_id
+      params[:usage_type] = usage_type if usage_type
+      params[:start_date] = start_date.iso8601 if start_date
+      params[:end_date] = end_date.iso8601 if end_date
+      
+      response = self.class.get("/v1/usage/events", query: params)
+      handle_response(response)
+      UsageEventList.new(response.parsed_response)
+    end
+    
+    def get_real_time_usage(subscriber_id)
+      response = self.class.get("/v1/subscribers/#{subscriber_id}/realtime")
+      handle_response(response)
+      RealTimeUsage.new(response.parsed_response)
+    end
+    
+    # Payment Management
+    
+    def create_payment_transaction(request)
+      response = self.class.post("/v1/payments/transactions", body: request.to_json)
+      handle_response(response)
+      PaymentTransaction.new(response.parsed_response)
+    end
+    
+    def get_payment_transaction(transaction_id)
+      response = self.class.get("/v1/payments/transactions/#{transaction_id}")
+      handle_response(response)
+      PaymentTransaction.new(response.parsed_response)
+    end
+    
+    def list_payment_transactions(subscriber_id: nil, status: nil, page: 1, page_size: 50)
+      params = { page: page, page_size: page_size }
+      params[:subscriber_id] = subscriber_id if subscriber_id
+      params[:status] = status if status
+      
+      response = self.class.get("/v1/payments/transactions", query: params)
+      handle_response(response)
+      PaymentTransactionList.new(response.parsed_response)
+    end
+    
+    # Rating Plans
+    
+    def list_rating_plans
+      response = self.class.get("/v1/rating-plans")
+      handle_response(response)
+      response.parsed_response.map { |plan| RatingPlan.new(plan) }
+    end
+    
+    def get_rating_plan(plan_id)
+      response = self.class.get("/v1/rating-plans/#{plan_id}")
+      handle_response(response)
+      RatingPlan.new(response.parsed_response)
+    end
+    
+    # System Management
+    
+    def get_system_stats
+      response = self.class.get("/v1/system/stats")
+      handle_response(response)
+      SystemStats.new(response.parsed_response)
+    end
+    
+    def get_health_status
+      response = self.class.get("/v1/health")
+      handle_response(response)
+      HealthStatus.new(response.parsed_response)
+    end
+    
+    # WebSocket Support
+    
+    def connect_websocket(message_handler: nil)
+      ws_url = @config.api_url.gsub("http://", "ws://") + "/ws"
+      
+      WebSocket::Client::Simple.connect(ws_url) do |ws|
+        ws.on :message do |msg|
+          begin
+            data = JSON.parse(msg.data)
+            ws_message = WebSocketMessage.new(data)
+            message_handler.call(ws_message) if message_handler
+          rescue JSON::ParserError => e
+            raise APIError, "Failed to parse WebSocket message: #{e.message}"
+          end
+        end
+      end
+    end
+    
+    # GraphQL Support
+    
+    def execute_graphql_query(query, variables = {})
+      request = { query: query, variables: variables }
+      response = self.class.post("/graphql", body: request.to_json)
+      handle_response(response)
+      GraphQLResponse.new(response.parsed_response)
+    end
+    
+    private
+    
+    def handle_response(response)
+      case response.code
+      when 401
+        raise AuthenticationError, "Authentication failed"
+      when 429
+        raise RateLimitError, "Rate limit exceeded"
+      when 400..499
+        error_data = response.parsed_response["error"] || "Bad request"
+        raise APIError, "API error: #{error_data}"
+      when 500..599
+        raise ServerError, "Server error: #{response.code}"
+      end
+      
+      response
+    end
+  end
+  
+  class Config
+    attr_accessor :api_url, :api_key, :timeout, :max_retries
+    
+    def initialize(options = {})
+      @api_url = options[:api_url] || "http://localhost:8000"
+      @api_key = options[:api_key]
+      @timeout = options[:timeout] || 30
+      @max_retries = options[:max_retries] || 3
+    end
+  end
+end
diff --git a/sdk/ruby/telecom_sdk.gemspec b/sdk/ruby/telecom_sdk.gemspec
new file mode 100644
index 0000000..fae0cb9
--- /dev/null
+++ b/sdk/ruby/telecom_sdk.gemspec
@@ -0,0 +1,26 @@
+Gem::Specification.new do |spec|
+  spec.name          = "telecom-sdk"
+  spec.version       = "1.0.0"
+  spec.authors       = ["Telecom Platform Team"]
+  spec.email         = ["team@telecom.example.com"]
+  spec.summary       = "Ruby SDK for Telecom Platform"
+  spec.description   = "Ruby SDK for interacting with the Telecom Platform API"
+  spec.homepage      = "https://github.com/nutcas3/telecom-platform"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  
+  spec.bindir        = "exe"
+  spec.executables   = spec.name.gsub(/^.*:/, "")
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "httparty", "~> 0.21"
+  spec.add_dependency "websocket-client-simple", "~> 0.3"
+  spec.add_dependency "json", "~> 2.6"
+  
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rubocop", "~> 1.21"
+end