Metadata-Version: 2.4
Name: langchain-veida
Version: 0.1.0
Summary: LangChain tool for Veida AI image generation, usable with no API key
Project-URL: Homepage, https://veida.ai
Project-URL: Source, https://github.com/hanshs474/langchain-veida
Project-URL: Documentation, https://veida.readthedocs.io/
Author: Veida
License-Expression: MIT
License-File: LICENSE
Keywords: ai,image-generation,langchain,no-api-key,text-to-image,tool
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.10
Requires-Dist: langchain-core>=0.3
Requires-Dist: veida>=0.1.0
Description-Content-Type: text/markdown

# langchain-veida

A LangChain tool that generates images with **no API key and no account**.

```bash
pip install langchain-veida
```

```python
from langchain_veida import VeidaImageGenerator

tool = VeidaImageGenerator()
url = tool.invoke({"prompt": "a paper boat on a calm lake at sunrise, soft light", "aspect_ratio": "16:9"})
# https://cdn.veida.ai/uploads/....webp
```

Hand it to an agent like any other tool:

```python
from langchain.agents import create_agent

agent = create_agent("openai:gpt-5-mini", tools=[VeidaImageGenerator()])
```

The tool calls the anonymous tier of [Veida](https://veida.ai/?utm_source=pypi-langchain&utm_medium=package),
so it works on a machine with nothing configured. Measured against the running service: one
image per client id (the library mints a new id each call), about seven images a day per
machine, 1K output with a watermark. A run takes 40 to 120 seconds.

When the free allowance is spent or the content filter refuses a prompt, the tool returns that
as text instead of raising, so the agent can wait or reword rather than crash.

Signing in on veida.ai removes the watermark and opens larger models such as
[GPT Image 2](https://veida.ai/image/gpt-image-2?utm_source=pypi-langchain&utm_medium=package)
for pictures that must contain readable text. Prompt examples live in the
[prompt library](https://veida.ai/image/prompts?utm_source=pypi-langchain&utm_medium=package).

Built on the zero-dependency [`veida`](https://pypi.org/project/veida/) client; full docs at
[veida.readthedocs.io](https://veida.readthedocs.io/). MIT.
