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

• 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

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,
});

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

1. Clone this repository:

git clone [email protected]:mattlebel/history-twister.git

2. Change to the project directory:

cd history-twister

3. Install dependencies:

npm install

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

OPENAI_API_KEY=your_openai_api_key

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

node initialize-db.js

Start the application by running:

npm start

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

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.

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

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

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

5. Deploy your application to Heroku:

git push heroku main

6. Open your deployed application in a web browser:

heroku open