FairyFlow — animated slides & animations in Python

FairyFlow logo

Documentation · Get started · Examples

FairyFlow is a Python-driven tool for creating animated slides and general-purpose animations. You write plain Python, and FairyFlow evaluates it live in an interactive environment that keeps your code, scene tree, and rendered result in sync.

FairyFlow interactive environment

Key features

  • Python-first authoring — animations are plain .py scripts; no DSL to learn
  • Live interactive environment — edit code, press Ctrl+Enter, see the result instantly
  • Easy scene exploration — code editor connects code, the scene tree, and elements in rendered image
  • Vector scene graph — scenes are stored as vector graphics and rasterized at the last moment, so any output resolution is lossless
  • Presentation cues — cue() pauses the player for click-to-advance presentations
  • Multiple export formats — standalone .ffpkg player package, MP4 video, and multi-page PDF
  • Performant backend — Backend is implemented in Rust

Documentation

https://spirali.github.io/fairyflow/

Quick start

pip install fairyflow

fairyflow init my_project
fairyflow open my_project

fairyflow open starts a local web server and prints the URL to the interactive studio. Open scenes/scene1.ffpy in the editor, write some code, and press Ctrl+Enter to evaluate:

with Scene():
    stext("Hello world!").fade_out()

Project layout

my_project/
├── fairyflow.toml       ← project settings (fps, prologue path)
├── prologue.py          ← shared imports and defaults for all scenes
├── scenes/
│   └── scene1.ffpy      ← animation code
└── sequences/
    └── sequence1.ffsq   ← ordered playlist of scenes for export

License

MIT — see LICENSE.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for spirali from gravatar.com spirali

Credits

Author: Ada Bohm

Requires

Python >=3.12

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

fairyflow-0.5.0-py3-none-win_amd64.whl (6.1 MB view details)

Uploaded Python 3Windows x86-64

fairyflow-0.5.0-py3-none-manylinux_2_17_x86_64.whl (7.6 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

fairyflow-0.5.0-py3-none-macosx_11_0_arm64.whl (6.0 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

File details

Details for the file fairyflow-0.5.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: fairyflow-0.5.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 6.1 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fairyflow-0.5.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 50799fe6e5dfbdf7f91e10b424f9d0785e391296874f622d6d705eabf04289f1
MD5 bb61aecdc158c4058f50a1aafda6fef0
BLAKE2b-256 2a6c7316d0a065a92e16d47a54cff7fe0dc43d86170a520cc5cfa21eb9bd823b

See more details on using hashes here.

Provenance

The following attestation bundles were made for fairyflow-0.5.0-py3-none-win_amd64.whl:

Publisher: build.yml on spirali/fairyflow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fairyflow-0.5.0-py3-none-manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for fairyflow-0.5.0-py3-none-manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 2208978f92d6323fc1c10e7208f07948902305a4eb352a2d3eedc0fd2db15d9b
MD5 417fc43f8ae9890bba20d8ef85fb0fb6
BLAKE2b-256 f047c05bbdabf20cd1ec8faee44cefdf9512e698097f57f21c7a9e59f506243c

See more details on using hashes here.

Provenance

The following attestation bundles were made for fairyflow-0.5.0-py3-none-manylinux_2_17_x86_64.whl:

Publisher: build.yml on spirali/fairyflow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fairyflow-0.5.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for fairyflow-0.5.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1fa5d5d1a771b1d342099975d1f5dcbbcf01cf302295b6b5fff068ab274e907b
MD5 01b683e8564fd885e90606f0ce1f3650
BLAKE2b-256 125329a740b7847d717fae87d3022b290762f5a0d5a0e9acac15bd72ee70d42b

See more details on using hashes here.

Provenance

The following attestation bundles were made for fairyflow-0.5.0-py3-none-macosx_11_0_arm64.whl:

Publisher: build.yml on spirali/fairyflow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.5.0 This release

3 files

0.4.0

3 files

0.3.0

3 files

0.2.0

3 files

0.1.0

3 files

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