This release is a pre-release and may not be stable for production use.
AAA1111
An Api for Automatic1111
설치
pip install aaa1111
pip를 통하여 설치할 수 있습니다.
사용법
1. CLI
aaa1111을 설치하면, txt2img, img2img 2가지 cli 명령어를 사용할 수 있습니다.
❯ txt2img --help
Usage: txt2img [OPTIONS] PARAMS...
╭─ api ───────────────────────────────────────────────────────────────────────────╮
│ * params PARAMS... Path to params files. .toml, .yaml, .yml, .json, │
│ .json5 available. others will be ignored. │
│ [required] │
╰─────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────────╮
│ --install-completion [bash|zsh|fish|powershel Install completion for │
│ l|pwsh] the specified shell. │
│ [default: None] │
│ --show-completion [bash|zsh|fish|powershel Show completion for the │
│ l|pwsh] specified shell, to copy │
│ it or customize the │
│ installation. │
│ [default: None] │
│ --help Show this message and │
│ exit. │
╰─────────────────────────────────────────────────────────────────────────────────╯
╭─ save ──────────────────────────────────────────────────────────────────────────╮
│ --save-dir -d DIRECTORY Path to save directory. │
│ [env var: AAA1111_SAVE_DIR] │
│ [default: output] │
│ --save-ext -e TEXT [default: png] │
│ --quality -q INTEGER [default: 95] │
│ --lossless --no-lossless [default: lossless] │
╰─────────────────────────────────────────────────────────────────────────────────╯
╭─ api ───────────────────────────────────────────────────────────────────────────╮
│ --base-url -b TEXT base url, if given, 'host', 'port' and │
│ 'https' are ignored. │
│ [env var: AAA1111_BASE_URL] │
│ [default: None] │
│ --host -h TEXT [default: 127.0.0.1] │
│ --port -p INTEGER [default: 7860] │
│ --https --no-https [default: no-https] │
╰─────────────────────────────────────────────────────────────────────────────────╯
--api옵션을 활성화한채 실행중인 webui가 필요합니다.
명령어 뒤에 입력 파라미터를 담은 파일의 경로를 1개 또는 그 이상 지정해주는 것으로 이미지를 생성합니다.
# 하나의 파일만 사용
txt2img examples/txt1.yaml
# glob 패턴
txt2img examples/txt*
지원하지 않는 확장자를 가진 파일은 무시됩니다.
.toml, .yaml, .yml, .json, .json5 5가지 확장을 지원하며, 파일은 하나의 python dict를 반환하도록 작성되어야 합니다.
예시: yaml
ruamel.yaml을 사용중이므로 기본적으로 yaml 1.2를 사용합니다.
prompt: masterpiece, best quality, 1girl
negative_prompt: (worst quality, low quality:1.1), text, title, logo, signature, (EasyNegativeV2:0.7), (negative_hand-neg:0.7)
sampler_name: DPM++ 2M Karras
batch_size: 2
n_iter: 1
cfg_scale: 7.5
width: 512
height: 768
steps: 20
override_settings:
CLIP_stop_at_last_layers: 2
alwayson_scripts:
Simple wildcards:
args: [] # Simple wildcards doesn't accept arguments
예시: toml
prompt = "masterpiece, best quality, 1girl"
negative_prompt = "(worst quality, low quality:1.1), text, title, logo, signature, (EasyNegativeV2:0.7), (negative_hand-neg:0.7)"
sampler_name = "DPM++ 2M Karras"
batch_size = 2
n_iter = 1
cfg_scale = 7.5
width = 512
height = 768
steps = 20
[override_settings]
CLIP_stop_at_last_layers = 2
[alwayson_scripts."Simple wildcards"]
args = [] # Simple wildcards doesn't accept arguments
예시: json5
// json5 example with comments
{
"prompt": "masterpiece, best quality, 1girl",
"negative_prompt": "(worst quality, low quality:1.1), text, title, logo, signature, (EasyNegativeV2:0.7), (negative_hand-neg:0.7)",
"sampler_name": "DPM++ 2M Karras",
"batch_size": 2,
"n_iter": 1,
"cfg_scale": 7.5,
"width": 512,
"height": 768,
"steps": 20,
"override_settings": {
"CLIP_stop_at_last_layers": 2
},
"alwayson_scripts": {
"Simple wildcards": {
"args": [], // Simple wildcards doesn't accept arguments
},
}, // Trailing comma available
}
2. python
기본 사용방법
from aaa1111 import AAA1111
from aaa1111.types import TXT2IMG, IMG2IMG
from aaa1111.types.extension import SimpleWildcards
api = AAA1111()
params = TXT2IMG(
prompt="masterpiece, best quality, 1girl, __woman_clothes__, __places__",
negative_prompt="(worst quality, low quality:1.1), text, title, logo, signature, (EasyNegativeV2:0.7), (negative_hand-neg:0.7)",
sampler_name="DPM++ 2M Karras",
batch_size=2,
n_iter=1,
cfg_scale=7.5,
width=512,
height=768,
steps=20,
override_settings={"CLIP_stop_at_last_layers": 2},
alwayson_scripts=[SimpleWildcards()]
)
resp = api.txt2img(txt2img)
images = resp.images
대신 설정 파일 경로를 넣을 수도 있습니다.
from aaa1111 import AAA1111
api = AAA1111()
resp = api.txt2img("examples/txt1.yaml")
images = resp.images
async 호출도 지원합니다.
import asyncio
from aaa1111 import AAA1111
async def gen():
api = AAA1111()
resp = await api.atxt2img("examples/txt1.yaml")
return resp.images
images = asyncio.run(gen())
Metadata
Release files for aaa1111 0.1.0.dev7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aaa1111-0.1.0.dev7.tar.gz | 1.2 MB | Without provenance | Details for aaa1111-0.1.0.dev7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aaa1111-0.1.0.dev7-py3-none-any.whl | Python 3 | none | any | Details for aaa1111-0.1.0.dev7-py3-none-any.whl |
Total release size: 1.2 MB
Release files / aaa1111-0.1.0.dev7.tar.gz
| Download URL | aaa1111-0.1.0.dev7.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
31dff3433a5921414838c56496711983a6358193b793867ad19f61773f9d97d3
|
|
BLAKE2b-256 checksum How to use checksums |
28c20a794f5e442c93f6e5d66d7bc67d99a7eb752590b8228d682995531848b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
pdm/2.8.0 CPython/3.11.4
|
Release files / aaa1111-0.1.0.dev7-py3-none-any.whl
| Download URL | aaa1111-0.1.0.dev7-py3-none-any.whl |
|---|---|
| Size | 21.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5fbc8a0f1ca66e76ac5f3baeb710ce01c87b7b603ec086f44d5830683411808d
|
|
BLAKE2b-256 checksum How to use checksums |
1ab05d06d4ee613b7d5a2c9a5ec0d5cda5e03c0168ef2d63248c4d39948666b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
pdm/2.8.0 CPython/3.11.4
|
Security for aaa1111 0.1.0.dev7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.