Bring Skyrim and Fallout 4 NPCs to life with AI
Mantella is a Skyrim and Fallout 4 mod which allows you to naturally speak to NPCs using Whisper (speech-to-text), LLMs (text generation), and xVASynth / XTTS (text-to-speech).
Click below or here to see the full trailer:
See art-from-the-machine.github.io/Mantella
See art-from-the-machine.github.io/Mantella/pages/issues_qna.html
See art-from-the-machine.github.io/Mantella/pages/installation.html#skyrim
The source code for Mantella is included in this repo. Please note that this development version of Mantella is prone to error and is not recommended for general use. See here for the latest stable release.
Here are the quick steps to get set up:
- Clone the repo to your machine
- Create a virtual environment via
py -3.11 -m venv MantellaEnv
in your console (Mantella requires Python 3.11) - Start the environment in your console (
.\MantellaEnv\Scripts\Activate
) - Install the required packages via
pip install -r requirements.txt
- Create a file called
GPT_SECRET_KEY.txt
and paste your secret key in this file - Set up your paths / any other required settings in the
config.ini
- Run Mantella via
main.py
in the parent directory
If you have any trouble in getting the repo set up, please reach out on Discord!
Related repos:
- Mantella Spell (Skyrim): https://github.com/art-from-the-machine/Mantella-Spell
- Mantella Gun (Fallout 4): https://github.com/YetAnotherModder/Fallout-4-VR-Mantella-Mod
- Mantella Gun (Fallout 4 VR): https://github.com/YetAnotherModder/Fallout-4-VR-Mantella-Mod
Updates made on one repo are often intertwined with the other, so it is best to ensure you have the latest versions of each when developing.
The source files for the Mantella docs are stored in the gh-pages branch.
Mantella uses material from the "Skyrim: Characters" articles on the Elder Scrolls wiki at Fandom and is licensed under the Creative Commons Attribution-Share Alike License.