---
license: mit
---
# isekai-rolename-vae

This project is designed to generate character names for isekai-style light novels using a GRU-Seq2Seq-VAE model.

## Overview

The `isekai-rolename-vae` project leverages neural networks to assist writers in crafting unique and fitting character names for isekai light novels. The model produces names that are easy to pronounce and align with genre conventions, without carrying specific meanings.

## Key Features

- **GRU-Seq2Seq-VAE Model**: Integrates GRU, Seq2Seq learning, and VAE to generate character names.
- **User-Friendly Interface**: Simplified setup for input parameters and retrieval of generated names.

## Getting Started

To begin using `isekai-rolename-vae`, follow these steps:

1. **Installation**: Clone the repository or download the source code.
   ```bash
   git clone https://huggingface.co/Sunbread/isekai-rolename-vae
   ```
2. **Dependencies**: Install the necessary Python libraries, including PyTorch.
3. **Inference**: Run the model to generate character names.

## Usage

To generate character names, execute the `inference.py` script from the command line. The script will output 16 names at a time:

```bash
cd isekai-rolename-vae
python ./inference.py
```

This command will load the model and generate 16 new character names for your isekai light novel.

## Acknowledgements

This project draws inspiration from the creative challenge of naming characters in isekai light novels, as explored in the article ["起名废即使在写异世界转生轻小说时也要从容生存——用GRU-Seq2Seq-VAE生成异世界轻小说人物名吧！"](https://zhuanlan.zhihu.com/p/637430709). The innovative use of neural networks for generating character names was a key influence in developing this project.

## License

This project is licensed under the [MIT License](LICENSE). Feel free to use and modify the code for your own projects.

Happy writing, and may your isekai characters come to life with distinctive names from this tool!