OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
AI APIs & Platforms

Perchance

Perchance is an unofficial Python library for generating text and images through Perchance. Its text interface yields output in chunks, and its image interface provides downloadable binary data for use in Python.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Perchance — OpenViST project profile in AI APIs & Platforms.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when a Python project needs the documented Perchance text-streaming or image-download workflows.

Who it is for

  • Python developers adding Perchance text generation to scripts or applications.
  • Developers who want to retrieve generated image data for Python-based workflows.

Documented uses

  • Send a prompt and consume generated text as a stream.
  • Generate an image from a prompt, download its binary data, and open it with Pillow.
Before you choose

Requirements & limits

The README specifies Python 3.11 and installation with pip. The image example imports Pillow.

  • The library is identified as an unofficial Perchance API.
  • Text and image generation use separate generator classes and asynchronous examples.
  • The image example uses Pillow to open downloaded image data.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Generate and stream text with the Perchance Python library

Install the library and print streamed text chunks for a prompt.

Before you start

  • Python 3.11, as indicated by the project badge.
  • The perchance package installed with pip.

Steps

  1. Install the package with the command below.

    Documented command
    pip install perchance

  2. In an asynchronous Python program, import asyncio and TextGenerator from perchance.

  3. Use async with TextGenerator() as gen, set a prompt, and iterate over gen.stream(prompt) with async for, printing each chunk.

  4. Start the asynchronous function with asyncio.run(main()).

Expected outcome

Text is printed incrementally as chunks are yielded by the generator.

Guide limitations

  • The project describes this as an unofficial Python API for Perchance.
  • The example demonstrates streaming output but does not specify output controls or reliability guarantees.
Documentation 1 ↗
Source-based practical guide

Generate and display a landscape image

Install the library and use it to generate, download, and display an image from a prompt.

Before you start

  • Python 3.11, as indicated by the project badge.
  • The perchance package installed with pip.
  • Pillow available for the example's PIL.Image import.

Steps

  1. Install the package with the command below.

    Documented command
    pip install perchance

  2. In an asynchronous Python program, import asyncio, Image from PIL, and ImageGenerator from perchance.

  3. Use async with ImageGenerator() as gen and call await gen.image(prompt, shape='landscape').

  4. Download the result with await result.download(), open it using Image.open(binary), and call image.show(); start the asynchronous function with asyncio.run(main()).

Expected outcome

The example downloads generated image data, opens it with Pillow, and requests that the image be shown.

Guide limitations

  • The project describes this as an unofficial Python API for Perchance.
  • The example does not document available shapes beyond landscape, nor specify image output or reliability guarantees.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
16 October 2026
Original website title
eeemoon/perchance · Official homepage title · retained in its source language
How we review sourcesSuggest a correction