tavus 0.1.0

data/lib/tavus/resources/videos.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Tavus
+  module Resources
+    class Videos
+      def initialize(client)
+        @client = client
+      end
+
+      # Generate a new video
+      # @param replica_id [String] Unique identifier for the replica (required)
+      # @param options [Hash] Additional parameters
+      # @option options [String] :script Text script for video generation (required if no audio_url)
+      # @option options [String] :audio_url URL to audio file (required if no script)
+      # @option options [String] :video_name Name for the video
+      # @option options [String] :background_url Link to website for background
+      # @option options [String] :background_source_url Direct link to background video
+      # @option options [String] :callback_url URL to receive callbacks
+      # @option options [Boolean] :fast Use fast rendering process (default: false)
+      # @option options [Boolean] :transparent_background Generate with transparent background (requires fast: true)
+      # @option options [String] :watermark_image_url URL to watermark image
+      # @option options [Hash] :properties Additional properties
+      # @return [Hash] The created video details
+      def create(replica_id:, **options)
+        body = options.merge(replica_id: replica_id)
+
+        # Validate that either script or audio_url is provided
+        unless body[:script] || body[:audio_url]
+          raise ArgumentError, "Either :script or :audio_url must be provided"
+        end
+
+        @client.post("/v2/videos", body: body)
+      end
+
+      # Convenient method to generate video from text
+      # @param replica_id [String] Unique identifier for the replica
+      # @param script [String] Text script for video generation
+      # @param options [Hash] Additional parameters
+      # @return [Hash] The created video details
+      def generate_from_text(replica_id:, script:, **options)
+        create(replica_id: replica_id, script: script, **options)
+      end
+
+      # Convenient method to generate video from audio
+      # @param replica_id [String] Unique identifier for the replica
+      # @param audio_url [String] URL to audio file
+      # @param options [Hash] Additional parameters
+      # @return [Hash] The created video details
+      def generate_from_audio(replica_id:, audio_url:, **options)
+        create(replica_id: replica_id, audio_url: audio_url, **options)
+      end
+
+      # Get a single video by ID
+      # @param video_id [String] The unique identifier of the video
+      # @param verbose [Boolean] Include additional video data like thumbnails (default: false)
+      # @return [Hash] The video details
+      def get(video_id, verbose: false)
+        params = verbose ? { verbose: true } : {}
+        @client.get("/v2/videos/#{video_id}", params: params)
+      end
+
+      # List all videos
+      # @param options [Hash] Query parameters
+      # @option options [Integer] :limit Number of videos to return per page (default: 10)
+      # @option options [Integer] :page Page number to return (default: 1)
+      # @return [Hash] List of videos and total count
+      def list(**options)
+        @client.get("/v2/videos", params: options)
+      end
+
+      # Delete a video
+      # @param video_id [String] The unique identifier of the video
+      # @param hard [Boolean] If true, hard delete video and assets (irreversible)
+      # @return [Hash] Success response
+      def delete(video_id, hard: false)
+        params = hard ? { hard: true } : {}
+        @client.delete("/v2/videos/#{video_id}", params: params)
+      end
+
+      # Rename a video
+      # @param video_id [String] The unique identifier of the video
+      # @param video_name [String] New name for the video
+      # @return [Hash] Success response
+      def rename(video_id, video_name)
+        @client.patch("/v2/videos/#{video_id}/name", body: { video_name: video_name })
+      end
+    end
+  end
+end
+

data/lib/tavus/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Tavus
+  VERSION = "0.1.0"
+end

data/lib/tavus.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "tavus/version"
+require_relative "tavus/configuration"
+require_relative "tavus/client"
+require_relative "tavus/errors"
+require_relative "tavus/resources/conversations"
+require_relative "tavus/resources/personas"
+require_relative "tavus/resources/replicas"
+require_relative "tavus/resources/objectives"
+require_relative "tavus/resources/guardrails"
+require_relative "tavus/resources/documents"
+require_relative "tavus/resources/videos"
+
+module Tavus
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: tavus
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vitor Oliveira
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-10-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  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: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: A Ruby gem for interacting with the Tavus Conversational Video Interface
+  API, supporting conversations and personas management.
+email:
+- vbrazo@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- examples/advanced_persona.rb
+- examples/basic_usage.rb
+- examples/complete_workflow.rb
+- lib/tavus.rb
+- lib/tavus/client.rb
+- lib/tavus/configuration.rb
+- lib/tavus/errors.rb
+- lib/tavus/resources/conversations.rb
+- lib/tavus/resources/documents.rb
+- lib/tavus/resources/guardrails.rb
+- lib/tavus/resources/objectives.rb
+- lib/tavus/resources/personas.rb
+- lib/tavus/resources/replicas.rb
+- lib/tavus/resources/videos.rb
+- lib/tavus/version.rb
+homepage: https://github.com/vbrazo/tavus
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/vbrazo/tavus
+  source_code_uri: https://github.com/vbrazo/tavus
+  changelog_uri: https://github.com/vbrazo/tavus/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: Ruby client for the Tavus API
+test_files: []