aigifmaker-haystack 0.1.0__py3-none-any.whl

aigifmaker_haystack/__init__.py

@@ -0,0 +1,6 @@
+"""Haystack component for AI GIF Maker (aigifmaker.ai): turn text into animated GIFs."""
+
+from aigifmaker_haystack.generators import AigifmakerGifGenerator
+
+__all__ = ["AigifmakerGifGenerator"]
+__version__ = "0.1.0"

aigifmaker_haystack/generators.py

@@ -0,0 +1,55 @@
+"""AI GIF Maker as a Haystack component.
+
+AI GIF Maker (https://aigifmaker.ai) turns text into animated GIFs with native
+GIF generation, no video conversion. The component runs on an AI GIF Maker
+account: pass ``api_key`` (a Haystack ``Secret``) or set ``AIGIFMAKER_API_KEY``.
+Create a key at https://aigifmaker.ai/settings/apikeys. Each GIF costs 1 credit
+on that account, the same as on the website.
+"""
+
+from typing import Any, Dict, List
+
+import aigifmaker
+from haystack import component, default_from_dict, default_to_dict
+from haystack.utils import Secret, deserialize_secrets_inplace
+
+
+@component
+class AigifmakerGifGenerator:
+    """Turns a text prompt into an animated GIF and returns its URL.
+
+    Usage:
+        ```python
+        from aigifmaker_haystack import AigifmakerGifGenerator
+
+        gen = AigifmakerGifGenerator()  # reads AIGIFMAKER_API_KEY
+        gen.run(prompt="a corgi in sunglasses dancing on a beach, looping")["gifs"]
+        ```
+    """
+
+    def __init__(
+        self,
+        api_key: Secret = Secret.from_env_var("AIGIFMAKER_API_KEY", strict=False),
+        timeout: float = 900.0,
+    ):
+        self.api_key = api_key
+        self.timeout = timeout
+
+    def to_dict(self) -> Dict[str, Any]:
+        return default_to_dict(self, api_key=self.api_key.to_dict(), timeout=self.timeout)
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "AigifmakerGifGenerator":
+        deserialize_secrets_inplace(data["init_parameters"], keys=["api_key"])
+        return default_from_dict(cls, data)
+
+    @component.output_types(gifs=List[str])
+    def run(self, prompt: str) -> Dict[str, List[str]]:
+        """Generate one GIF.
+
+        Raises an ``aigifmaker.AigifmakerError`` subclass (``AuthError``,
+        ``QuotaError``, ``RejectedError``, ``GenerationFailed``) on a refusal,
+        an empty balance, a failed run or a timeout.
+        """
+        url = aigifmaker.generate(prompt, api_key=self.api_key.resolve_value(), timeout=self.timeout)
+        return {"gifs": [url]}

aigifmaker_haystack-0.1.0.dist-info/METADATA

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: aigifmaker-haystack
+Version: 0.1.0
+Summary: Haystack component for AI GIF Maker (aigifmaker.ai): turn text into animated GIFs in a pipeline
+Project-URL: Homepage, https://aigifmaker.ai/?utm_source=pypi-haystack&utm_medium=package
+Project-URL: Pricing, https://aigifmaker.ai/pricing
+Project-URL: Documentation, https://aigifmaker.readthedocs.io/en/latest/
+Project-URL: Source, https://github.com/hanshs474/aigifmaker-haystack
+Author-email: AI GIF Maker <support@aigifmaker.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,aigifmaker,animated-gif,gif,gif-generator,haystack,pipeline,text-to-gif
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.9
+Requires-Dist: aigifmaker>=0.1.1
+Requires-Dist: haystack-ai>=2.0
+Description-Content-Type: text/markdown
+
+# aigifmaker-haystack
+
+Turn text into animated GIFs with AI GIF Maker. Native GIF generation — no video conversion. Type what you want and download your GIF in about a minute.
+
+This is a [Haystack](https://haystack.deepset.ai) component for [AI GIF Maker](https://aigifmaker.ai/?utm_source=pypi-haystack&utm_medium=package): drop `AigifmakerGifGenerator` into a pipeline and every prompt comes out as a link to a finished `.gif`.
+
+```bash
+pip install aigifmaker-haystack
+export AIGIFMAKER_API_KEY=sk-...   # create one at https://aigifmaker.ai/settings/apikeys
+```
+
+```python
+from aigifmaker_haystack import AigifmakerGifGenerator
+
+AigifmakerGifGenerator().run(prompt="a corgi in sunglasses dancing on a beach, looping")
+# {"gifs": ["https://.../....gif"]}
+```
+
+## In a pipeline
+
+Let an LLM write the GIF idea, then render it:
+
+```python
+from haystack import Pipeline
+from haystack.components.builders import PromptBuilder
+from haystack.components.generators import OpenAIGenerator
+from aigifmaker_haystack import AigifmakerGifGenerator
+
+p = Pipeline()
+p.add_component("brief", PromptBuilder("Write one short GIF prompt reacting to: {{message}}. Say what moves and that it loops."))
+p.add_component("llm", OpenAIGenerator())
+p.add_component("gif", AigifmakerGifGenerator())
+p.connect("brief", "llm")
+p.connect("llm.replies", "gif.prompt")
+```
+
+(`llm.replies` is a list; add a small adapter component that takes `replies[0]` if your Haystack version does not convert it.)
+
+## Component
+
+`AigifmakerGifGenerator(api_key=Secret.from_env_var("AIGIFMAKER_API_KEY"), timeout=900.0)`
+
+- Input: `prompt` (str), what the GIF shows and how it moves.
+- Output: `gifs`, a list with one GIF URL.
+- Serializes with `to_dict` / `from_dict`; the key stays a Haystack `Secret`.
+- Errors come from the [`aigifmaker`](https://pypi.org/project/aigifmaker/) SDK: `AuthError` (no key or a wrong key), `QuotaError` (out of credits), `RejectedError` (the content filter refused; reword), `GenerationFailed` (the run failed and its credit was refunded).
+
+## Cost
+
+Each GIF costs 1 credit on your AI GIF Maker account, the same as on the website. New accounts get one free GIF (it carries a small aigifmaker.ai badge). Credit packs are on the [pricing](https://aigifmaker.ai/pricing?utm_source=pypi-haystack&utm_medium=package) page.
+
+Questions: support@aigifmaker.ai. MIT licensed. Source: https://github.com/hanshs474/aigifmaker-haystack

aigifmaker_haystack-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+aigifmaker_haystack/__init__.py,sha256=7TdQefz9nxiHiwOeYRPW9859V34ZaAkXPLTMNPMIWYs,216
+aigifmaker_haystack/generators.py,sha256=2gpSPmY_ixch7dtR6OEqLMR2HzCYsd8S3vWy1IXizVk,2015
+aigifmaker_haystack-0.1.0.dist-info/METADATA,sha256=nNO9KYLsnCR7iNyEfgKiMFTKxi9b66qd0CgkbBeqGhU,3272
+aigifmaker_haystack-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+aigifmaker_haystack-0.1.0.dist-info/licenses/LICENSE,sha256=GDXpAv3-ST6EtIxLtWyHR8-pallbvHTxgvOYLSDi0zY,1093
+aigifmaker_haystack-0.1.0.dist-info/RECORD,,

aigifmaker_haystack-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

aigifmaker_haystack-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI GIF Maker (https://aigifmaker.ai)
+
+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.