app

This app allows you to speak to all character features in the curriculum.

Installation

1. Start a GitHub Codespaces
2. Run npm install
3. Run npm start
4. Open http://localhost:3000

You should see something like:

Speak to a character

You're faced with a text input field. Type your message and see the response from the character you are speaking to.

Change character

Select the dropdown to change the character you are speaking to.

Change the character behavior

In characters.json, there's a description property that will be used as a system message. If you change this, the character's personality will change.

Please read

Important

DISCLAIMER: This repository contains fictional content generated by AI. The historical characters depicted here are generating responses thanks to generative AI, which is based on training data. Any responses generated by these characters do not represent their actual views or quotes. This content is intended solely for entertainment purposes. Microsoft Responsible AI principles here

Optional Task: Adding audio

• Adding background audio, download the music (make sure it's royalty free). Place it in the public/audio folder and name it according to the name field in characters.json, for example "davinci.mp3".

• Locate the TODO comment in index.html and uncomment the rows regarding playing background audio, should look something like this:

  /*
   TODO: undo this comment once you've downloaded background music corresponding to your character
   see characters.json name field what to name a file, for example davinci.mp3
   */
   // backgroundAudio.src = `/audio/${character.name}.mp3`; // Updated to use character.name
   // backgroundAudio.volume = maxVolume;
  
  
   // backgroundAudio.play();

Free resources for music

If you want to add free music to your own fork for the sake of experimentation on your own fork or clone.

• Pixabay https://pixabay.com

  Here are some ideas you could try (remember many songs on this site have a creative commons license CC meaning it's only for personal projects unless it says CC0 in which case you can use it freely. ):

  • Montezuma, https://pixabay.com/music/world-magical-ritual-shaman-amazonian-indians-197516/
  • Ada Lovelace, https://pixabay.com/music/classical-string-quartet-adagio-pour-cordes-289664/
  • Dinocrates, https://pixabay.com/music/mystery-ancient-181070/
  • Leonardo Da Vinci, https://pixabay.com/music/folk-medieval-background-196571/
  • Ludovico Sforza, https://pixabay.com/music/build-up-scenes-medieval-opener-270568/

• https://freemusicarchive.org/

and many more.