pycaps-ai 0.2.1__tar.gz

pycaps_ai-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Franco Zanardi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pycaps_ai-0.2.1/MANIFEST.in

@@ -0,0 +1,4 @@
+graft src/pycaps/effect/sound/presets
+graft src/pycaps/template/preset
+include src/pycaps/renderer/previewer/previewer.html
+include src/pycaps/transcriber/editor/editor.html

pycaps_ai-0.2.1/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: pycaps-ai
+Version: 0.2.1
+Summary: A Python tool to edit videos and automatically add CSS-styled subtitles to videos.
+Author-email: Aleef Bilal <aleefbilal@gmail.com>
+Maintainer-email: Aleef Bilal <aleefbilal@gmail.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/AleefBilal/pycaps
+Project-URL: Repository, https://github.com/AleefBilal/pycaps
+Project-URL: Bug Tracker, https://github.com/AleefBilal/pycaps/issues
+Keywords: video,subtitles,video editing,whisper,captions
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow
+Requires-Dist: numpy
+Requires-Dist: pydantic
+Requires-Dist: typer
+Requires-Dist: requests
+Requires-Dist: multiprocess
+Requires-Dist: tqdm
+Requires-Dist: movielite
+Requires-Dist: platformdirs
+Provides-Extra: fast
+Requires-Dist: html2pic; extra == "fast"
+Requires-Dist: google-cloud-speech; extra == "fast"
+Provides-Extra: base
+Requires-Dist: openai-whisper; extra == "base"
+Requires-Dist: playwright; extra == "base"
+Requires-Dist: pywebview; extra == "base"
+Provides-Extra: all
+Requires-Dist: openai-whisper; extra == "all"
+Requires-Dist: google-cloud-speech; extra == "all"
+Requires-Dist: playwright; extra == "all"
+Requires-Dist: pywebview; extra == "all"
+Requires-Dist: html2pic; extra == "all"
+Dynamic: license-file
+
+# pycaps
+
+[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](https://github.com/AleefBilal/pycaps)
+[![PyPI](https://img.shields.io/pypi/v/pycaps-ai.svg)](https://pypi.org/project/pycaps-ai/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](https://www.python.org/downloads/)
+[![Hugging Face Spaces](https://img.shields.io/badge/Try%20it%20online-Hugging%20Face-blue?logo=huggingface)](https://huggingface.co/spaces/francozanardi/pycaps-new)
+
+
+**pycaps** is a Python tool for adding CSS styled subtitles to videos. It's designed as both a programmable library and a command-line interface (CLI), making it perfect for automating the creation of dynamic content for platforms like TikTok, YouTube Shorts, and Instagram Reels.
+
+> **Note:** This is a community fork published on PyPI as [`pycaps-ai`](https://pypi.org/project/pycaps-ai/). The original project is [francozanardi/pycaps](https://github.com/francozanardi/pycaps).
+
+![demo-1](https://github.com/user-attachments/assets/fd2d3325-c986-4b6a-81ba-09c428577e61)
+![demo-2](https://github.com/user-attachments/assets/9a789244-0387-4ac8-ab51-b3601447953e)
+
+<sub>See more examples on <a href="https://www.pycaps.com/">pycaps.com</a></sub>
+
+## Try It Online (no installation needed!)
+
+You have two options to test `pycaps` directly in your browser (hosted by the [original project](https://github.com/francozanardi/pycaps)). Choose the one that best fits your needs.
+
+### 1. Interactive Web Demo (on Hugging Face)
+
+Ideal for a **quick preview**, testing built-in templates, and **editing captions** with a user-friendly interface.
+
+[![Hugging Face Spaces](https://img.shields.io/badge/Launch%20Web%20Demo-Hugging%20Face-blue?logo=huggingface)](https://huggingface.co/spaces/francozanardi/pycaps-new)
+
+> **Keep in mind:**
+> *   This demo runs on a shared, CPU-only environment, so it's best for **short videos (< 60 seconds)**.
+> *   For a private, faster experience, you can **[duplicate the Space](https://huggingface.co/spaces/francozanardi/pycaps-new?duplicate=true)** for free.
+
+### 2. Full-Power Notebook (on Google Colab)
+
+The best choice for **processing longer videos** with **maximum transcription quality**, using a free GPU provided by Google.
+
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/117g6xujecjLyXHBwhwyzx0innCMLh_nj?usp=sharing)
+
+> **Keep in mind:**
+> *   The interface is a step-by-step code notebook, not a graphical UI.
+> *   You will be guided to enable the GPU for the best performance.
+
+## Key Features
+
+*   **Template System**: Get started quickly with predefined templates. Create and share your own templates, packaging styles, animations, and configurations.
+*   **CSS Styling**: Style subtitles using standard CSS. Target specific states like `.word-being-narrated` for dynamic effects, cleanly separating style from logic.
+*   **Word Tagging**: Tag words or phrases using regular expressions, word lists, or AI. These tags act as powerful selectors for applying custom CSS, effects, or animations.
+*   **Advanced Animations & Effects**: Bring words to life with a library of built-in animations (fades, pops, slides) and effects (typewriting, emoji insertion, sound effects).
+*   **Whisper-based Transcription**: Automatically generate accurate, word-level timestamps for your videos using OpenAI's Whisper.
+*   **Dual Interface**: Use it as a simple CLI for quick renders or as a comprehensive Python library for programmatic video creation.
+*   **Offline-First**: The core transcription, styling, and rendering engine runs entirely on your local machine. An internet connection is only needed for optional AI-powered features that require contextual understanding of your script.
+
+## Prerequisites
+
+Before installing, please ensure your environment meets the following requirements:
+
+*   **Python Version**: `pycaps` was tested on **Python 3.10, 3.11, and 3.12**. Other versions may present issues.
+
+*   **FFmpeg**: You need to have FFmpeg installed on your system and accessible from your command line's `PATH`. This is essential for all audio and video processing tasks.
+    *   You can download it from [ffmpeg.org](https://ffmpeg.org/download.html) and follow a guide to add it to your system's `PATH`.
+
+## Installation
+
+1.  **Install FFmpeg**: Ensure you have completed the prerequisite step above.
+
+2.  **Install from PyPI:**
+
+    **Full installation (recommended):**
+    ```bash
+    pip install "pycaps-ai[all]"
+    ```
+
+    **Custom installation with specific features:**
+    ```bash
+    # Whisper + Playwright + transcription editor (default setup)
+    pip install "pycaps-ai[base]"
+
+    # Lighter rendering: Google Speech + html2pic (no browser)
+    pip install "pycaps-ai[fast]"
+    ```
+
+    **Install from GitHub (latest dev):**
+    ```bash
+    pip install "git+https://github.com/AleefBilal/pycaps.git#egg=pycaps-ai[all]"
+    ```
+
+3.  **Install Browser Dependencies for Rendering:**
+    `pycaps` currently has two different options to render the subtitle images:
+    - `CssSubtitleRenderer`, which is the original and default one. It uses Playwright to render CSS styles. So, you need to install its browser dependency to use it:
+      ```bash
+      playwright install chromium
+      ```
+    - `PictexSubtitleRenderer`, which is a light-weight option. It doesn't use a browser, but it only support a subset of CSS, and it may present some visual differences in the result (specially in the shadows, you should modify the CSS from the templates to get the same results). To use it, you must call `with_custom_subtitle_renderer(PictexSubtitleRenderer())` when `CapsPipelineBuilder()` is created.
+
+> ⚠️ **Note**: The first time you use `pycaps`, it will also download a Whisper AI model for transcription. This may take a few minutes and only happens once.
+
+## Quick Start
+
+There are two primary ways to use pycaps: via the command line with a template or programmatically in a Python script.
+
+### 1. Using the Command-Line (CLI)
+
+The fastest way to get started is to use a built-in template.
+
+```bash
+pycaps render --input my_video.mp4 --template minimalist
+```
+
+This command will:
+1.  Load the `minimalist` template.
+2.  Transcribe the audio from `my_video.mp4`.
+3.  Apply the template's styles and animations.
+4.  Save the result in a new file.
+
+If you already have a transcript from another tool, you can skip built-in transcription:
+
+```bash
+pycaps render --input my_video.mp4 --template minimalist --transcript transcript.json
+```
+
+Supported transcript formats: `whisper_json`, `pycaps_json`, `srt`, `vtt` (`--transcript-format` is optional and defaults to `auto`).
+
+### 2. Using the Python Library
+
+For full control, use the `CapsPipelineBuilder` in your Python code.
+
+```python
+from pycaps import CapsPipelineBuilder
+
+# The pipeline contains multiples stages to render the final video
+pipeline = (
+    CapsPipelineBuilder()
+    .with_input_video("input.mp4")
+    .add_css("css_file.css")
+    .build()
+)
+pipeline.run() # When this is executed, it starts to render the video
+```
+
+You can also preload the builder using a Template.
+```python
+from pycaps import *
+
+# Load a template and configure it
+builder = TemplateLoader("default").with_input_video("my_video.mp4").load(False)
+
+# Programmatically add an animation
+builder.add_animation(
+    animation=FadeIn(),
+    when=EventType.ON_NARRATION_STARTS,
+    what=ElementType.SEGMENT
+)
+
+# Build and run the pipeline
+pipeline = builder.build()
+pipeline.run()
+```
+
+## What's Next?
+
+*   🚀 **For Command-Line Users**: Check the **[CLI Usage Guide](./docs/CLI.md)** for a quick and easy start.
+*   🧠 **For Developers**: Understand the core concepts in the **[Structure Guide](./docs/CORE_STRUCTURE.md)**.
+*   🏷️ **Styling & Logic**: Learn about the powerful **[Tagging System](./docs/TAGS.md)**.
+*   🎨 **Reusable Styles**: See how **[Templates](./docs/TEMPLATES.md)** work and how to create your own.
+*   💡 **Inspiration**: Dive into **[Code & JSON Examples](./docs/EXAMPLES.md)**.
+*   🔧 **Advanced Config**: See all options in the **[JSON Configuration Reference](./docs/CONFIG_REFERENCE.md)**.
+*   🤖 **AI Features**: Learn about AI-powered features in the **[API Usage Guide](./docs/API_USAGE.md)**.
+
+## Contributing
+
+This project is in active development. Contributions, bug reports, and feature requests are welcome! Please open an issue or pull request on our [GitHub repository](https://github.com/AleefBilal/pycaps).
+
+## License
+
+pycaps is licensed under the [MIT License](https://opensource.org/licenses/MIT). Originally created by [Franco Zanardi](https://github.com/francozanardi/pycaps).

pycaps_ai-0.2.1/README.md

@@ -0,0 +1,175 @@
+# pycaps
+
+[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](https://github.com/AleefBilal/pycaps)
+[![PyPI](https://img.shields.io/pypi/v/pycaps-ai.svg)](https://pypi.org/project/pycaps-ai/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](https://www.python.org/downloads/)
+[![Hugging Face Spaces](https://img.shields.io/badge/Try%20it%20online-Hugging%20Face-blue?logo=huggingface)](https://huggingface.co/spaces/francozanardi/pycaps-new)
+
+
+**pycaps** is a Python tool for adding CSS styled subtitles to videos. It's designed as both a programmable library and a command-line interface (CLI), making it perfect for automating the creation of dynamic content for platforms like TikTok, YouTube Shorts, and Instagram Reels.
+
+> **Note:** This is a community fork published on PyPI as [`pycaps-ai`](https://pypi.org/project/pycaps-ai/). The original project is [francozanardi/pycaps](https://github.com/francozanardi/pycaps).
+
+![demo-1](https://github.com/user-attachments/assets/fd2d3325-c986-4b6a-81ba-09c428577e61)
+![demo-2](https://github.com/user-attachments/assets/9a789244-0387-4ac8-ab51-b3601447953e)
+
+<sub>See more examples on <a href="https://www.pycaps.com/">pycaps.com</a></sub>
+
+## Try It Online (no installation needed!)
+
+You have two options to test `pycaps` directly in your browser (hosted by the [original project](https://github.com/francozanardi/pycaps)). Choose the one that best fits your needs.
+
+### 1. Interactive Web Demo (on Hugging Face)
+
+Ideal for a **quick preview**, testing built-in templates, and **editing captions** with a user-friendly interface.
+
+[![Hugging Face Spaces](https://img.shields.io/badge/Launch%20Web%20Demo-Hugging%20Face-blue?logo=huggingface)](https://huggingface.co/spaces/francozanardi/pycaps-new)
+
+> **Keep in mind:**
+> *   This demo runs on a shared, CPU-only environment, so it's best for **short videos (< 60 seconds)**.
+> *   For a private, faster experience, you can **[duplicate the Space](https://huggingface.co/spaces/francozanardi/pycaps-new?duplicate=true)** for free.
+
+### 2. Full-Power Notebook (on Google Colab)
+
+The best choice for **processing longer videos** with **maximum transcription quality**, using a free GPU provided by Google.
+
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/117g6xujecjLyXHBwhwyzx0innCMLh_nj?usp=sharing)
+
+> **Keep in mind:**
+> *   The interface is a step-by-step code notebook, not a graphical UI.
+> *   You will be guided to enable the GPU for the best performance.
+
+## Key Features
+
+*   **Template System**: Get started quickly with predefined templates. Create and share your own templates, packaging styles, animations, and configurations.
+*   **CSS Styling**: Style subtitles using standard CSS. Target specific states like `.word-being-narrated` for dynamic effects, cleanly separating style from logic.
+*   **Word Tagging**: Tag words or phrases using regular expressions, word lists, or AI. These tags act as powerful selectors for applying custom CSS, effects, or animations.
+*   **Advanced Animations & Effects**: Bring words to life with a library of built-in animations (fades, pops, slides) and effects (typewriting, emoji insertion, sound effects).
+*   **Whisper-based Transcription**: Automatically generate accurate, word-level timestamps for your videos using OpenAI's Whisper.
+*   **Dual Interface**: Use it as a simple CLI for quick renders or as a comprehensive Python library for programmatic video creation.
+*   **Offline-First**: The core transcription, styling, and rendering engine runs entirely on your local machine. An internet connection is only needed for optional AI-powered features that require contextual understanding of your script.
+
+## Prerequisites
+
+Before installing, please ensure your environment meets the following requirements:
+
+*   **Python Version**: `pycaps` was tested on **Python 3.10, 3.11, and 3.12**. Other versions may present issues.
+
+*   **FFmpeg**: You need to have FFmpeg installed on your system and accessible from your command line's `PATH`. This is essential for all audio and video processing tasks.
+    *   You can download it from [ffmpeg.org](https://ffmpeg.org/download.html) and follow a guide to add it to your system's `PATH`.
+
+## Installation
+
+1.  **Install FFmpeg**: Ensure you have completed the prerequisite step above.
+
+2.  **Install from PyPI:**
+
+    **Full installation (recommended):**
+    ```bash
+    pip install "pycaps-ai[all]"
+    ```
+
+    **Custom installation with specific features:**
+    ```bash
+    # Whisper + Playwright + transcription editor (default setup)
+    pip install "pycaps-ai[base]"
+
+    # Lighter rendering: Google Speech + html2pic (no browser)
+    pip install "pycaps-ai[fast]"
+    ```
+
+    **Install from GitHub (latest dev):**
+    ```bash
+    pip install "git+https://github.com/AleefBilal/pycaps.git#egg=pycaps-ai[all]"
+    ```
+
+3.  **Install Browser Dependencies for Rendering:**
+    `pycaps` currently has two different options to render the subtitle images:
+    - `CssSubtitleRenderer`, which is the original and default one. It uses Playwright to render CSS styles. So, you need to install its browser dependency to use it:
+      ```bash
+      playwright install chromium
+      ```
+    - `PictexSubtitleRenderer`, which is a light-weight option. It doesn't use a browser, but it only support a subset of CSS, and it may present some visual differences in the result (specially in the shadows, you should modify the CSS from the templates to get the same results). To use it, you must call `with_custom_subtitle_renderer(PictexSubtitleRenderer())` when `CapsPipelineBuilder()` is created.
+
+> ⚠️ **Note**: The first time you use `pycaps`, it will also download a Whisper AI model for transcription. This may take a few minutes and only happens once.
+
+## Quick Start
+
+There are two primary ways to use pycaps: via the command line with a template or programmatically in a Python script.
+
+### 1. Using the Command-Line (CLI)
+
+The fastest way to get started is to use a built-in template.
+
+```bash
+pycaps render --input my_video.mp4 --template minimalist
+```
+
+This command will:
+1.  Load the `minimalist` template.
+2.  Transcribe the audio from `my_video.mp4`.
+3.  Apply the template's styles and animations.
+4.  Save the result in a new file.
+
+If you already have a transcript from another tool, you can skip built-in transcription:
+
+```bash
+pycaps render --input my_video.mp4 --template minimalist --transcript transcript.json
+```
+
+Supported transcript formats: `whisper_json`, `pycaps_json`, `srt`, `vtt` (`--transcript-format` is optional and defaults to `auto`).
+
+### 2. Using the Python Library
+
+For full control, use the `CapsPipelineBuilder` in your Python code.
+
+```python
+from pycaps import CapsPipelineBuilder
+
+# The pipeline contains multiples stages to render the final video
+pipeline = (
+    CapsPipelineBuilder()
+    .with_input_video("input.mp4")
+    .add_css("css_file.css")
+    .build()
+)
+pipeline.run() # When this is executed, it starts to render the video
+```
+
+You can also preload the builder using a Template.
+```python
+from pycaps import *
+
+# Load a template and configure it
+builder = TemplateLoader("default").with_input_video("my_video.mp4").load(False)
+
+# Programmatically add an animation
+builder.add_animation(
+    animation=FadeIn(),
+    when=EventType.ON_NARRATION_STARTS,
+    what=ElementType.SEGMENT
+)
+
+# Build and run the pipeline
+pipeline = builder.build()
+pipeline.run()
+```
+
+## What's Next?
+
+*   🚀 **For Command-Line Users**: Check the **[CLI Usage Guide](./docs/CLI.md)** for a quick and easy start.
+*   🧠 **For Developers**: Understand the core concepts in the **[Structure Guide](./docs/CORE_STRUCTURE.md)**.
+*   🏷️ **Styling & Logic**: Learn about the powerful **[Tagging System](./docs/TAGS.md)**.
+*   🎨 **Reusable Styles**: See how **[Templates](./docs/TEMPLATES.md)** work and how to create your own.
+*   💡 **Inspiration**: Dive into **[Code & JSON Examples](./docs/EXAMPLES.md)**.
+*   🔧 **Advanced Config**: See all options in the **[JSON Configuration Reference](./docs/CONFIG_REFERENCE.md)**.
+*   🤖 **AI Features**: Learn about AI-powered features in the **[API Usage Guide](./docs/API_USAGE.md)**.
+
+## Contributing
+
+This project is in active development. Contributions, bug reports, and feature requests are welcome! Please open an issue or pull request on our [GitHub repository](https://github.com/AleefBilal/pycaps).
+
+## License
+
+pycaps is licensed under the [MIT License](https://opensource.org/licenses/MIT). Originally created by [Franco Zanardi](https://github.com/francozanardi/pycaps).

pycaps_ai-0.2.1/pyproject.toml

@@ -0,0 +1,76 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pycaps-ai"
+version = "0.2.1"
+authors = [
+  { name = "Aleef Bilal", email = "aleefbilal@gmail.com" },
+]
+maintainers = [
+  { name = "Aleef Bilal", email = "aleefbilal@gmail.com" },
+]
+description = "A Python tool to edit videos and automatically add CSS-styled subtitles to videos."
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT License"}
+keywords = ["video", "subtitles", "video editing", "whisper", "captions"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License", 
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Text Processing :: Linguistic",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "Pillow",
+    "numpy",
+    "pydantic",
+    "typer",
+    "requests",
+    "multiprocess",
+    "tqdm",
+    "movielite",
+    "platformdirs"
+]
+
+[project.optional-dependencies]
+fast = [
+    "html2pic",
+    "google-cloud-speech"
+]
+base = [
+    "openai-whisper",
+    "playwright",
+    "pywebview",
+]
+all = [
+    "openai-whisper",
+    "google-cloud-speech",
+    "playwright",
+    "pywebview",
+    "html2pic"
+]
+
+[project.scripts]
+pycaps = "pycaps.cli:app"
+
+[project.urls]
+"Homepage" = "https://github.com/AleefBilal/pycaps"
+"Repository" = "https://github.com/AleefBilal/pycaps"
+"Bug Tracker" = "https://github.com/AleefBilal/pycaps/issues"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]

pycaps_ai-0.2.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pycaps_ai-0.2.1/src/pycaps/__init__.py

@@ -0,0 +1,13 @@
+from .pipeline import CapsPipeline, CapsPipelineBuilder, JsonConfigLoader
+from .renderer import CssSubtitleRenderer, PictexSubtitleRenderer
+from .transcriber import WhisperAudioTranscriber, GoogleAudioTranscriber, AudioTranscriber, LimitByWordsSplitter, LimitByCharsSplitter, SplitIntoSentencesSplitter, TranscriptFormat, load_transcription
+from .effect import *
+from .animation import *
+from .selector import WordClipSelector
+from .tag import TagCondition, BuiltinTag, TagConditionFactory, SemanticTagger
+from .common import *
+from .layout.definitions import *
+from .ai import LlmProvider
+from .template import TemplateLoader, TemplateFactory, DEFAULT_TEMPLATE_NAME
+
+__version__ = "0.2.1" 

pycaps_ai-0.2.1/src/pycaps/ai/__init__.py

@@ -0,0 +1,5 @@
+from .gpt import Gpt
+from .llm import Llm
+from .llm_provider import LlmProvider
+
+__all__ = ["Gpt", "Llm", "LlmProvider"]

pycaps_ai-0.2.1/src/pycaps/ai/gpt.py

@@ -0,0 +1,35 @@
+from pycaps.ai.llm import Llm
+import os
+
+class Gpt(Llm):
+
+    OPENAI_API_KEY_NAME = "PYCAPS_OPENAI_API_KEY"
+
+    def __init__(self):
+        self._client = None
+
+    def send_message(self, prompt: str, model: str = "gpt-4.1-mini") -> str:
+        return self._get_client().responses.create(model=model, input=prompt).output_text
+    
+    def is_enabled(self) -> bool:
+        return os.getenv(self.OPENAI_API_KEY_NAME) is not None
+
+    def _get_client(self):
+        try:
+            from openai import OpenAI
+
+            if self._client:
+                return self._client
+
+            self._client = OpenAI(api_key=os.getenv(self.OPENAI_API_KEY_NAME))
+            return self._client
+        except ImportError:
+            raise ImportError(
+                "OpenAI API not found. "
+                "Please install it with: pip install openai"
+            )
+        except Exception as e:
+            raise RuntimeError(
+                f"Error initializing OpenAI client: {e}\n\n"
+                "Please ensure you have authenticated correctly via PYCAPS_OPENAI_API_KEY."
+            )

pycaps_ai-0.2.1/src/pycaps/ai/llm.py

@@ -0,0 +1,11 @@
+from abc import ABC, abstractmethod
+
+class Llm(ABC):
+
+    @abstractmethod
+    def send_message(self, message: str, model: str) -> str:
+        pass
+
+    @abstractmethod
+    def is_enabled(self) -> bool:
+        pass

pycaps_ai-0.2.1/src/pycaps/ai/llm_provider.py

@@ -0,0 +1,16 @@
+from typing import Optional
+from .llm import Llm
+from .gpt import Gpt
+
+class LlmProvider:
+    _llm: Optional[Llm] = None
+
+    @staticmethod
+    def get() -> Llm:
+        if LlmProvider._llm is None:
+            LlmProvider._llm = Gpt()
+        return LlmProvider._llm
+    
+    @staticmethod
+    def set(llm: Llm):
+        LlmProvider._llm = llm

pycaps_ai-0.2.1/src/pycaps/animation/__init__.py

@@ -0,0 +1,31 @@
+# src/pycaps/animator/__init__.py
+
+from .builtin import *
+from .definitions import Transformer, OvershootConfig, Direction
+from .primitive_animation import PrimitiveAnimation
+from .preset_animation import PresetAnimation
+from .animation import Animation
+from .element_animator import ElementAnimator
+
+__all__ = [
+    "Animation",
+    "PrimitiveAnimation",
+    "PresetAnimation",
+    "ElementAnimator",
+    "Transformer",
+    "OvershootConfig",
+    "Direction",
+    "SlideInPrimitive",
+    "ZoomInPrimitive",
+    "PopInPrimitive",
+    "FadeInPrimitive",
+    "FadeIn",
+    "FadeOut",
+    "PopIn",
+    "PopOut",
+    "PopInBounce",
+    "SlideIn",
+    "SlideOut",
+    "ZoomIn",
+    "ZoomOut",
+]

pycaps_ai-0.2.1/src/pycaps/animation/animation.py

@@ -0,0 +1,11 @@
+from pycaps.common import WordClip, ElementType
+from abc import ABC, abstractmethod
+
+class Animation(ABC):
+    def __init__(self, duration: float, delay: float = 0.0) -> None:
+        self._duration: float = duration
+        self._delay: float = delay
+
+    @abstractmethod
+    def run(self, clip: WordClip, offset: float, what: ElementType) -> None:
+        pass

pycaps_ai-0.2.1/src/pycaps/animation/builtin/__init__.py

@@ -0,0 +1,18 @@
+from .primitive import *
+from .preset import *
+
+__all__ = [
+    "FadeIn",
+    "FadeOut",
+    "SlideIn",
+    "SlideOut",
+    "ZoomIn",
+    "ZoomOut",
+    "PopIn",
+    "PopOut",
+    "PopInBounce",
+    "FadeInPrimitive",
+    "PopInPrimitive",
+    "ZoomInPrimitive",
+    "SlideInPrimitive",
+]