Skip to main content helper classes and methods

Project description


PyPI - Version PyPI - Downloads

The AI-powered preview system built from your website (no effort required).

Flayyer live image

This module is agnostic to any Python framework.


Get started (5 minutes)

Haven't registered your website yet? Go to and create a project (e.g. website-com).

1. Install the library

This module requires Python >= 3.6.

Install it with Poetry.

poetry add flayyer

Or install it with pip.

pip install flayyer

2. Get your smart image link

In your website code (e.g. your landing or product/post view file), set the following:

from flayyer import FlayyerAI

flayyer = FlayyerAI(
  # Your project slug
  # The current path of your website
  path="/path/to/product", # In Django you can use {{ request.get_full_path }}

# Check:
# >

3. Put your smart image link in your <head> tags

You'll get the best results like this:

<meta property="og:image" content="{{ flayyer.href() }}">
<meta name="twitter:image" content="{{ flayyer.href() }}">
<meta name="twitter:card" content="summary_large_image">

4. Create a rule for your project

Login at > Go to your Dashboard > Manage rules and create a rule like the following:

Flayyer basic rule example


Advanced usage

Advanced features include:

  • Custom variables: additional information for your preview that is not present in your website. [Note: if you need customization you should take a look at]
  • Custom metadata: set custom width, height, resolution, and more (see example).
  • Signed URLs.

Here you have a detailed full example for project website-com and path /path/to/product.

from flayyer import FlayyerAI, FlayyerMeta

flayyer = FlayyerAI(
  # [Required] Your project slug, find it in your dashboard
  # [Recommended] The current path of your website (by default it's `/`).
  # [Optional] In case you want to provide information that is not present in your page set it here.
    "title": "Product name",
    "img": "",
  # [Optional] Custom metadata for rendering the image. ID is recommended so we provide you with better statistics.
    id="jeans-123", # recommended for better stats
    v="12369420123", # specific handler version, by default it's a random number to circumvent platforms' cache,
    resolution=0.9, # from 0.0 to 1.0
    agent="whatsapp", # force dimensions for specific platform

# Check:
# >

For signed URLs, just provide your secret (find it in Dashboard > Project > Advanced settings) and choose a strategy (HMAC or JWT).

flayyer = FlayyerAI(
  strategy="JWT", # or 'HMAC'

# >

As you probably realized, uses the rules defined on your dashboard to decide how to handle every image based on path patterns. It fetches and analyse your website for obtaining information and then rendering a content-rich image increasing the click-through-rate with no effort. Let's say "FlayyerAI render images based on the content of this route". instead requires you to explicitly declare template and variables for the images to render, giving you more control for customization. Let's say "FlayyerIO render an image using this template and these explicit variables".

from flayyer import Flayyer

flayyer = Flayyer(
    variables={"title": "Hello world!"},

# Use this image in your <head/> tags
url = flayyer.href()
# >

Variables can be complex arrays and hashes.

from flayyer import Flayyer, FlayyerMeta

flayyer = Flayyer(
        "items": [
            { "text": "Oranges", "count": 12 },
            { "text": "Apples", "count": 14 },
        id="slug-or-id", # To identify the resource in our analytics report

IMPORTANT: variables must be serializable.

To decode the URL for debugging purposes:

from urllib.parse import unquote

# >!&__v=123


Prepare the local environment:

poetry install
poetry shell

Deploy with:

# Set API Token
poetry config pypi-token.pypi pypi-TOKEN

poetry version X.Y.Z
poetry build
poetry publish


Run tests with pytest:

poetry run pytest

Run black linter:

black .

Project details

Download files

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

Source Distribution

flayyer-1.2.0.tar.gz (6.0 kB view hashes)

Uploaded source

Built Distribution

flayyer-1.2.0-py3-none-any.whl (5.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page