9 items
File information
Created by
YetAnotherModderUploaded by
sirboomerVirus scan
Some manually verified files
About this mod
NEW UPDATE-Mantella has arrived to Fallout4 desktop & VR! Mantella allows you to have actual conversations with NPCs using your voice or text input by using Moonshine/Whisper for speech-to-text, LLMs for text generation, and Piper,xVASynth & XTTS for text-to-speech. NPCs have memories of your past conversations and are aware of in-game even
- Requirements
- Permissions and credits
-
Translations
- Spanish
- Changelogs
What's new in 0.13.0:
See the trailer:
See Mantella in action:
Installation
See link here for installation instructions . IMPORTANT : Returning players will need to follow the upgrade process to update their Mantella version to 0.13.0.
How to start conversations
How to use the game event key
Recommended mod(s)
Key Features
FAQ
Can I use Mantella with text input?
Absolutely. You have to disable to disable the microphone in the config.ini (see installation docs, link above) then press "H" in-game to respond to NPCs (desktop only).
Can I use Mantella with VR or desktop?
Yes it's compatible with both.
How much does it cost to run Mantella?
At a minimum, nothing. If your hardware is strong enough to support running local language models you can run completely offline for free. If you would prefer to outsource this processing externally, you can also use OpenAI or OpenRouter:
OpenAI: The OpenAI API (note: not ChatGPT Plus!) is billed on a monthly basis on a pay-per-use basis. So far the most I have spent in a single month of (part-time) development is $3.40.
OpenRouter: The OpenRouter API is billed by using pre-paid credits. There are a number of language model to choose from, and there are often models available for free. See here for more details
Are there high PC hardware requirements to run this?
If you are using external LLM services like OpenAI or Openrouter, then the only requirements are running the TTS and Moonshine/Whisper STT (if using the microphone). PiperTTS and Moonshine /Whisper can easily be run on most modern CPUs, the former uses about 0.1 gb of RAM and the latter about 1 gb.
Local minimum specs:
A local LLM will need a minimum 6 gb of free RAM & VRAM to run a basic role-playing capable LLM.
Local minimum specs:
XTTS Specs: Using XTTS will add another requirement of 2-4 gbs of RAM and VRAM.
What are the storage requirements for this mod?
The base install is about 7 gb using Piper Text-to-Speech. Mantella Software itself is 400 mbs but will need 1-5 gb of temporary files.
Does this work with local language models?
Yes.
Compatibility
Supported Languages
Credits
Issues
Uninstallation
Community
If you would like to stay up to date on the project or would like share your experiences (and issues!) please find the link to the Discord here: https://discord.gg/Q4BJAdtGUE
See my youtube channel for Mantella video showcases.
- MUCH EASIER INSTALL PROCESS! This was the main feedback we received from users and we heard you, Mantella is now more straightforward to install and requires less components to get up and running.
- New web browser user interface for user configuration that allows for on the fly changes! Upon launching Mantella in Fallout 4 is will automatically open a new configuration tab on your default web browser.
- F4SE integration: The Mantella Mod esp package now has a F4SE files that are used for direct communication with Mantella Software a lot more other cool stuff!
- Direct in engine dialogue audio and subtitles. Now the characters will speak their Mantella generated dialogue directly in the game interface in an immersive manner.
- Fallout 4 NG compatibility: Mantella is now compatible with the latest FO4 patch!
- Fewer dependencies : Mantella doesn't require SUP F4SE or the DLCs anymore.
- Vision support: If the AI LLM model is able to analyze images, you can configure Mantella through the web browser interface to enable image analysis. Keep in mind this will increase the cost of responses by a fraction, and could also increase the response time.
- Vastly increased stability: Mantella's code has been refactored and is now much more reliable than before. That means fewer dropped conversations.
- Piper TTS support: Piper TTS (not to be confused with Piper the NPC reporter) is an alternative to XTTS and XVASynth, it uses less resources and smaller model files making it an interesting option for new users that don't want the hassle of downloading a hundred large voice models.
- Merged the desktop and VR esp mods together in a single package.
- New actions through Mantella dialogue: NPC can now open inventories to allow trade
- NPCs can now stay in place during dialogue if this option is enabled
- NPCs can refrain from activating most random scripted dialogue during a Mantella conversation if this option is enabled
- The player's Mantella replies can now by voiced through a voice of your choosing.
- Narration support : Mantella supports using a narrator voice to describe non-verbal descriptions.
- Multiple bugfixes
See the trailer:
See Mantella in action:
Installation
See link here for installation instructions . IMPORTANT : Returning players will need to follow the upgrade process to update their Mantella version to 0.13.0.
How to start conversations
- You will obtain automatically the gun and holotape after loading as long as you're past the first Vault.
- Follow the instructions in the in-game tutorial to start your first conversation.
How to use the game event key
- During a conversation, press the "Y" key to add to type a text event in the game (e.g. "Piper heard a gunshot"). It's best to use a third person perspective to mesh with the game events that are automatically sent to the NPCs. You can do this multiple times in a row.
- When you actually reply to the NPC, either by speaking in the microphone or by typing a reply (default "H" key), all the game events will be sent along the reply to the AI. Note : the game event log will get cleared at the start of a new conversation.
Recommended mod(s)
- The default in-game dialogue will interrupt Mantella's dialogue. In game measures are in place to attempt to prevent this but nevertheless NPCs might step in on your AI powered conversations .You can use a mod like No NPC Greetings to prevent NPCs from interrupting your conversations.
Key Features
- Interact with every NPC, including modded NPCs
- 600+ NPCs have been given their own unique background descriptions
- Support for local, OpenAI, and OpenRouter language models
- Bundled with Piper for audio text-to-speech.
- XTTS support for voice generation in addition to XVASynth
- Partial compatibility with multiple languages. Meaning : all 3.0 XVASynth voice models are compatible with multiple languages but older models aren't.
- NPCs remember past conversations with you
- NPCs are aware of in-game info such as their location, the current time, picking up and equipping items, sleeping, taking regular or radiation damage, entering power armors, being given commands or settlement assignments.
- NPCs can start conversations with each other (Radiant Dialogue)
- Can have a conversation with multiple NPCs at once (up to 5)
- Fully playable in desktop or VR (make sure to download the appropriate mod)
- NPCs can be convinced to follow your commands, open their inventories, or may attack you if you offend them
FAQ
Can I use Mantella with text input?
Absolutely. You have to disable to disable the microphone in the config.ini (see installation docs, link above) then press "H" in-game to respond to NPCs (desktop only).
Can I use Mantella with VR or desktop?
Yes it's compatible with both.
How much does it cost to run Mantella?
At a minimum, nothing. If your hardware is strong enough to support running local language models you can run completely offline for free. If you would prefer to outsource this processing externally, you can also use OpenAI or OpenRouter:
OpenAI: The OpenAI API (note: not ChatGPT Plus!) is billed on a monthly basis on a pay-per-use basis. So far the most I have spent in a single month of (part-time) development is $3.40.
OpenRouter: The OpenRouter API is billed by using pre-paid credits. There are a number of language model to choose from, and there are often models available for free. See here for more details
Are there high PC hardware requirements to run this?
If you are using external LLM services like OpenAI or Openrouter, then the only requirements are running the TTS and Moonshine/Whisper STT (if using the microphone). PiperTTS and Moonshine /Whisper can easily be run on most modern CPUs, the former uses about 0.1 gb of RAM and the latter about 1 gb.
Local minimum specs:
A local LLM will need a minimum 6 gb of free RAM & VRAM to run a basic role-playing capable LLM.
Local minimum specs:
XTTS Specs: Using XTTS will add another requirement of 2-4 gbs of RAM and VRAM.
What are the storage requirements for this mod?
The base install is about 7 gb using Piper Text-to-Speech. Mantella Software itself is 400 mbs but will need 1-5 gb of temporary files.
Does this work with local language models?
Yes.
Compatibility
- WARS - Weapon Addition and Replacement Suite has been reported as a compatibility issue.
- Fallout Mantella is compatible with Windows 10 / 11 (tested for both)
- Quick Trade & What's Your Name will conflict with Mantella for the alternate activation option. You can use the holotape followed by [-> Main Settings -> Remove conversation activation option] to resolve the conflict.
Supported Languages
- Arabic (Partial support)
- Danish (Partial support)
- Dutch (Partial support)
- English (Full support)
- Finnish (Partial support)
- French (Partial support)
- German (Partial support)
- Greek (Partial support)
- Hausa (Partial support)
- Hungarian (Partial support)
- Italian (Partial support)
- Korean (Partial support)
- Polish (Partial support)
- Portuguese (Partial support)
- Romanian (Partial support)
- Russian (Partial support)
- Spanish (Partial support)
- Swahili (Partial support)
- Swedish (Partial support)
- Turkish (Partial support)
- Ukrainian (Partial support)
- Vietnamese (Partial support)
- Yoruba (Partial support)
Credits
- Art from the Machine
- Leidtier
- Peteben
- Pendrokar
- d&f
- Mahe
- mercury7
- MrHaurrus
- Pathos
- teddybear082
- tonycubed2
- SiftingSands
- slavkovsky77
- koukisdevki
- TomahawkJackson
- Shawn/Kakarrot
- thomastieyi
- Kinggath for part of the Listener Script
- And all the testers
Issues
- See the troubleshooting section of the game file's manual or go to the Mantella Discord here: https://discord.gg/Q4BJAdtGUE
Uninstallation
- End all Mantella conversations in-game
- Remove the Mantella Mod using Vortex / Mod Organizer 2
- Delete the My Games/Mantella/ folder (if you would like to save your data,
keep your My Games/Mantella/data/Fallout4 folder somewhere
safe)
Community
If you would like to stay up to date on the project or would like share your experiences (and issues!) please find the link to the Discord here: https://discord.gg/Q4BJAdtGUE
See my youtube channel for Mantella video showcases.