/history-twister

This application uses the OpenAI API to generate creative, alternative versions of historical events based on user prompts.

Primary LanguageHTML

History Twister

History Twister image

This app was written, debugged, and deployed entirely by ChatGPT (GPT-4) in April 2023.

Production demo URL: https://historytwister.com

Generate historical fiction with History Twister, powered by AI. This application uses the OpenAI API to generate creative, alternative versions of historical events based on user prompts.

Here's an example:

Newspaper article: It's a day after the United States has surrendered to Axis powers and lost World War 2. Citizens are being instructed to report to their respective internment camps.

Result: https://historytwister.com/results.html?twist=63af0cbc-8bc6-4dff-98c8-d88c2c61cd2f

Features

  • Responsive design with a navbar and About modal
  • Parses and respects line breaks in API responses
  • Share twisted history via Email and Twitter with unique result URLs
  • CTA buttons to twist history again or start over

Good to know

Heads up that the hosted version has been hitting some API soft cap limits from public usage, so I updated the max_tokens value in the prompt to be 350 (about 250 words) in early May 2023.

If you're running this locally, you will get more interesting results if you adjust your max_tokens value to be 1024 (or similar).

In app.js:

const response = await openai.createChatCompletion({
  model: "gpt-3.5-turbo",
  messages: [
    { role: "system", content: "You are a famous historical figure with a vivid imagination and deep knowledge of historical events. You are known for your comprehensive and engaging writing style that accurately reflects the time period you're writing about. Your task is to create a captivating and detailed alternative history based on the user's prompt. Use your creativity to explore the consequences of this scenario and provide a unique perspective on how this event would have unfolded. Remember to use language and references appropriate for the time period, and make sure to keep your audience captivated with your storytelling skills." },
    { role: "user", content: `Create a ${outputFormat} based on the following alternative history scenario: ${prompt}` },
  ],
  temperature: 0.8,
  // Set max token value here
  max_tokens: 300,
});

Getting Started

Prerequisites

  • Node.js and npm installed on your machine
  • An OpenAI API key

Installing

  1. Clone this repository:

git clone git@github.com:mattlebel/history-twister.git

  1. Change to the project directory:

cd history-twister

  1. Install dependencies:

npm install

  1. Create a .env file in the project root and add your OpenAI API key:

OPENAI_API_KEY=your_openai_api_key

  1. Initialize the database by running the initialize-db.js script:

node initialize-db.js

Running the Application

Start the application by running:

npm start

The application should now be running at http://localhost:3000.

Database Configuration

For local development, this application uses SQLite. For production, it uses PostgreSQL. The application automatically switches between SQLite and PostgreSQL based on the NODE_ENV environment variable.

Deploying to Heroku

  1. Install the Heroku CLI and log in to your Heroku account: heroku login

  2. Create a new Heroku application:

heroku create your-app-name

  1. Via the Heroku dashboard, add the Heroku PostgreSQL add-on

  2. Via the Heroku dashboard, set your OpenAI API key and NODE_ENV as Heroku environment variables

  3. Deploy your application to Heroku:

git push heroku main

  1. Open your deployed application in a web browser:

heroku open