Metadata-Version: 2.4
Name: aihordeclient
Version: 0.3.2
Summary: AI Horde client to ease creation of plugins
Author: Igor Támara
Author-email: Igor Támara <igor.tamara@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Dist: sseclient-py==1.8.0
Requires-Dist: urllib3==2.2.3
Requires-Python: >=3.8
Project-URL: Homepage, https://github.com/ikks/aihordeclient
Project-URL: Issues, https://github.com/ikks/aihordeclient/issues
Description-Content-Type: text/markdown

# AIHordeclient

AIHordeclient is a lib to connect to https://aihorde.net/api/v2 and
ease plugin development.

There is an [official Python-SDK](https://pypi.org/project/aihorde/) from [AIHorde](https://aihorde.net).

## USAGE

```sh
pip install aihordeclient
```

<details>
<summary>In order to run a simple use and see the client in action, do:</summary>

```sh
git clone https://github.com/ikks/aihordeclient/
cd aihordeclient
uv venv -p 3.13
source .venv/bin/activate
uv pip install aihordeclient
AIHORDE_API_KEY=<yourapikey> uv run main.py
```

On success you will have a webp downloaded file in your temp directory.

<img width="1324" height="610" alt="screensnot-2025-08-26-151233-annotated" src="https://github.com/user-attachments/assets/350c7b67-9b57-46cb-94c6-05a8bd1cccda" />


This screenshot under [Debian](https://www.debian.org), [Sway](https://swaywm.org/) [Kitty terminal](https://sw-kovidgoyal-net.translate.goog/kitty/), [uv](https://docs.astral.sh/uv) and using [vv](https://github.com/wolfpld/moderncore/blob/master/doc/vv.md) to display the image.


</details>

Look at [https://github.com/ikks/aihordeclient/blob/main/main.py](main.py) for the simplest sample, for other real
use cases, see:

* [stablehorde-gimp3](https://github.com/ikks/gimp-stable-diffusion/)
* [libreoffice-stable-horde](https://github.com/ikks/libreoffice-stable-diffusion/)

Get an AIHORDE [free api_key](https://aihorde.net/register) to run
the sample code, once you have installed the package.

# AUTHORS

Most of the code descends from
[blueturtleai Gimp 2.10.X plugin](https://github.com/blueturtleai/gimp-stable-diffusion)
initial work.

# THANKS

* AIHorde
