TAIConvert

This CLI can be used to easily convert TavernAI character images to JSON for the different pygmalion Web-UIs.

Index

• Installation
• Usage
  • Conversion
  • Extraction

Installation

Install this tool using pipx:

$ pipx install taiconvert

Normal pip installation is also possible:

$ pip install taiconvert

You can also used the pre-built pyinstaller binary from the releases page.

Usage

For help, run:

$ taiconvert --help

You can also use:

$ python -m taiconvert --help

Conversion

To convert a single image, run:

$ taiconvert convert <path/to/image>

The output will be written to <imagename>.pygmalion.json in the same directory as the image.

To convert multiple images, run:

$ taiconvert convert <path/to/image1> <path/to/image2> <path/to/image3> ...

Extraction

To extract the character json from a TavernAI character image file, run:

$ taiconvert extract <path/to/image>

The output will be written to <imagename>.tavernai.json in the same directory as the image.

To extract multiple images, run:

$ taiconvert extract <path/to/image1> <path/to/image2> <path/to/image3> ...

Development

To contribute to this tool, first checkout the code. Then create a new virtual environment:

$ pipx install virtualenv
$ cd taiconvert
$ virtualenv .venv
$ .venv/Scripts/activate

Now install the dependencies and install the pre-commit hooks:

$ pip install -e '.[dev]'
$ pre-commit install