aigifmaker-haystack 0.1.0__tar.gz

aigifmaker_haystack-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+dist/
+__pycache__/
+.pytest_cache/
+.venv/
+*.egg-info/

aigifmaker_haystack-0.1.0/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.

aigifmaker_haystack-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,52 @@
+# 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/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "aigifmaker-haystack"
+version = "0.1.0"
+description = "Haystack component for AI GIF Maker (aigifmaker.ai): turn text into animated GIFs in a pipeline"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [{ name = "AI GIF Maker", email = "support@aigifmaker.ai" }]
+keywords = ["haystack", "ai", "gif", "gif-generator", "text-to-gif", "animated-gif", "pipeline", "aigifmaker"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Multimedia :: Graphics",
+]
+dependencies = ["haystack-ai>=2.0", "aigifmaker>=0.1.1"]
+
+[project.urls]
+Homepage = "https://aigifmaker.ai/?utm_source=pypi-haystack&utm_medium=package"
+Pricing = "https://aigifmaker.ai/pricing"
+Documentation = "https://aigifmaker.readthedocs.io/en/latest/"
+Source = "https://github.com/hanshs474/aigifmaker-haystack"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/aigifmaker_haystack"]

aigifmaker_haystack-0.1.0/src/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-0.1.0/src/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/tests/test_generators.py

@@ -0,0 +1,61 @@
+from unittest import mock
+
+import aigifmaker
+import pytest
+from haystack.utils import Secret
+from aigifmaker_haystack import AigifmakerGifGenerator
+
+
+def test_run_and_roundtrip(monkeypatch):
+    monkeypatch.setenv("AIGIFMAKER_API_KEY", "sk-env")
+    gen = AigifmakerGifGenerator.from_dict(AigifmakerGifGenerator(timeout=120).to_dict())
+    with mock.patch.object(aigifmaker, "generate", return_value="https://cdn.aigifmaker.ai/a.gif") as g:
+        assert gen.run(prompt="a corgi") == {"gifs": ["https://cdn.aigifmaker.ai/a.gif"]}
+    assert g.call_args.args[0] == "a corgi"
+    assert g.call_args.kwargs == {"api_key": "sk-env", "timeout": 120}
+
+
+def _with_transport(responses):
+    seq = iter(responses)
+    real = aigifmaker.generate
+    t = lambda method, url, body, headers: (200, next(seq))
+    return mock.patch.object(aigifmaker, "generate", side_effect=lambda *a, **k: real(*a, transport=t, poll_every=0, **k))
+
+
+def test_queue_then_success():
+    with _with_transport([
+        {"code": 0, "data": {"id": "t1", "status": "pending"}},
+        {"code": 0, "data": {"id": "t1", "status": "processing", "queued": True, "queueEta": 10}},
+        {"code": 0, "data": {"id": "t1", "status": "success", "images": ["https://x/a.gif"]}},
+    ]):
+        assert AigifmakerGifGenerator(api_key=Secret.from_token("sk")).run(prompt="x") == {"gifs": ["https://x/a.gif"]}
+
+
+@pytest.mark.parametrize("body,err", [
+    ({"code": -1, "message": "invalid API key"}, aigifmaker.AuthError),
+    ({"code": 0, "data": {"wall": True, "reason": "anon_credits"}}, aigifmaker.AuthError),
+    ({"code": -1, "message": "insufficient credits"}, aigifmaker.QuotaError),
+    ({"code": 429, "message": "content cooldown"}, aigifmaker.RejectedError),
+])
+def test_errors(body, err):
+    with _with_transport([body]):
+        with pytest.raises(err):
+            AigifmakerGifGenerator(api_key=Secret.from_token("sk")).run(prompt="x")
+
+
+def test_failed():
+    with _with_transport([{"code": 0, "data": {"id": "t1"}}, {"code": 0, "data": {"id": "t1", "status": "failed", "errorMessage": "boom"}}]):
+        with pytest.raises(aigifmaker.GenerationFailed):
+            AigifmakerGifGenerator(api_key=Secret.from_token("sk")).run(prompt="x")
+
+
+# live smoke, free: no generation happens on either path
+def test_live_wrong_key():
+    with pytest.raises(aigifmaker.AuthError):
+        AigifmakerGifGenerator(api_key=Secret.from_token("sk-invalidtest000")).run(prompt="smoke test")
+
+
+def test_live_no_key(monkeypatch):
+    monkeypatch.delenv("AIGIFMAKER_API_KEY", raising=False)
+    with pytest.raises(aigifmaker.AuthError):
+        AigifmakerGifGenerator().run(prompt="smoke test")