Skip to main content

Fabler

CI PyPI Status Badge PyPI - Python Version Code style: black License: MIT


A multi-model AI story teller, built with Stable Diffusion, GPT, and neural text-to-speech (TTS).

Given a prompt as an opening line of a story, GPT writes the rest of the plot; Stable Diffusion draws an image for each sentence; a TTS model narrates each line, resulting in a fully animated video of a short story, replete with audio and visuals.

demo animation

Quickstart

Check it out now Open In Colab or follow the instructions below to install locally.

Install from PyPi

$ pip install fabler

Install from Source

  1. Clone the repository
$ git clone https://github.com/christopherwoodall/fabler.git
  1. Install package requirements.
$ pip install --upgrade pip wheel
$ pip install -e ".[developer]"
  1. Run the demo. The final video will be saved as /out/out.mp4, alongside other intermediate images, audio files, and subtitles.
$ fabler --scene=scene.yaml

4 Alternatively with make:

make install && make run

Usage

  1. Load the model with defaults.
from fabler import Fabler

story_teller = Fabler.from_defaults()
story_teller.generate(...)
  1. Alternatively, configure the model with custom settings.
from fabler import Fabler, FablerConfig

config = FablerConfig(
    writer="gpt2-large",
    painter="CompVis/stable-diffusion-v1-4",
    max_new_tokens=100,
    diffusion_prompt_prefix="Van Gogh style",
)

story_teller = Fabler(config)
story_teller.generate(...)

License

Released under the MIT License.

Metadata

Release files for fabler 0.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for fabler 0.0.6
File Interpreter ABI Platform
fabler-0.0.6-py3-none-any.whl Python 3 none any Details

Release files / fabler-0.0.6-py3-none-any.whl

Download URL fabler-0.0.6-py3-none-any.whl
Size 91.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d605795fcdfb81c5673b3a519294e9f9fac5e983617158ae3a836f136e1d60fd
BLAKE2b-256 checksum
How to use checksums
dd317f185979877777234de0282c46d35f36d5fcaa8ecd034af86fbe3c70960c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.4

Security for fabler 0.0.6

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page