Skip to main content

A package for generating stories about future concepts that are physically implementable.

Project description

futurephysics

futurephysics is a Python package that generates stories about future concepts that are not to far fetched, i.e. concepts should be possible to be implemented. It uses OpenAI's GPT-4, DALL-E models and Wikipedia to generate the story and corresponding images.

Background

It's great to have all these creative tools. One efficient way to use them is to create glorious visions of humanity's future, which will probably be powered by technology. I am a big fan of the Project Hieroglyph, an initiative of the University of Arizona. This initiative can be best explained by quoting from Wikipedia: "an initiative to create science fiction in order to spur innovation in science and technology." The goal of this repository and the easy-to-use Python package is to replicate this project but with generative AI and Wikipedia. I've also seen a few tweets where people tried to create visionary concepts with AI in Twitter threads:

Installation

You can install futurephysics from PyPI:

pip install futurephysics

Usage

Here's a basic example of how to use futurephysics:

from futurephysics import story

#Replace 'your-openai-api-key' with your actual OpenAI API key
openai_api_key = 'your-openai-api-key'

#Generate a story
html = story(openai_api_key)

The html variable contains the story formatted as HTML.

You can also provide your own list of three categories with which the story gets drafted:

from futurephysics import story

#Replace 'your-openai-api-key' with your actual OpenAI API key
openai_api_key = 'your-openai-api-key'

#Generate a story
html = story(openai_api_key, categories=["Computational archaeology", "Cosmogony", "Plants"])

The story is generated based on these categories.

Since the Dalle3 API is used, the returned image URLs expire after a while. You can provide details to your Google bucket for hosting images (the bucket needs to be public for this):

from futurephysics import story

#Replace 'your-openai-api-key' with your actual OpenAI API key
openai_api_key = 'your-openai-api-key'

#Generate a story
html = story(openai_api_key, google_id="your-google-id", google_bucket="your-google-id")

Examples

All stories which can be find on futurephysics.org were created by the library.

Contributing

If you run into any issues, the most helpful thing you can do is open an issue on GitHub. Thank you so much!

Roadmap

  • Improve image selection from Wikipedia
  • Improve image generation via DALL-E
  • Improve prompting

License

This project is licensed under the MIT License.

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

futurephysics-0.8.tar.gz (15.2 kB view details)

Uploaded Source

Built Distribution

futurephysics-0.8-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

Details for the file futurephysics-0.8.tar.gz.

File metadata

  • Download URL: futurephysics-0.8.tar.gz
  • Upload date:
  • Size: 15.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for futurephysics-0.8.tar.gz
Algorithm Hash digest
SHA256 1d6c42786729c7822a9108b6da0dc5e5df80a7de5a7a6a31763d007d622bb7bc
MD5 ee46e60ce082ca447c31024c631ec028
BLAKE2b-256 bd7892c03502dff63c3b36932fc6856fd48a21ad44049b70aacd95a93a626d04

See more details on using hashes here.

File details

Details for the file futurephysics-0.8-py3-none-any.whl.

File metadata

  • Download URL: futurephysics-0.8-py3-none-any.whl
  • Upload date:
  • Size: 14.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for futurephysics-0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 2c9654d25ab224ec222df7b029374d52a47258f18c6a53a7b604052dc6dba96a
MD5 f53744509e6ac08c323f79ba5f102ba5
BLAKE2b-256 c1ff03cc675d7eb0b59df16ae2c0761ff06c609f2dcd717e40836658d4809988

See more details on using hashes here.

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