semvec/pypi-packages huggingface dataset:
neuralnest 0.1.0
NeuralNest: An open-source personal AI assistant designed for seamless data integration from various sources, offering versatile connections to Language Learning Models (LLMs), enhanced security, and human-in-the-loop options for a personalized AI experience.
Requires Python: >=3.10,<4.0

# NeuralNest: Your Personal AI Assistant (WIP)

**🚧 This project is currently under heavy development and might not have stable features yet. 🚧**

NeuralNest aims to be an open-source personal AI assistant designed to seamlessly integrate data from various sources. With the vision to connect to different Language Learning Models (LLMs), both locally hosted and remote, NeuralNest will offer versatility and adaptability. The project will prioritize security and also plans to support human-in-the-loop options for a more personalized AI experience.

## Planned Features

- **Data Integration**: Easily fetch and integrate data from multiple sources.
- **Versatile Connections**: Connect to various LLMs, both local and remote.
- **Enhanced Security**: Multiple security levels to safeguard your data.
- **Human-in-the-Loop**: Improve AI responses with human intervention options.

## Installation (Coming Soon)

Details on installation and setup will be provided as the project progresses.

## Usage (Coming Soon)

A comprehensive guide on how to use NeuralNest will be available once core features are implemented.

## Contributing

While the project is in its early stages, we appreciate any feedback or ideas. If you're interested in contributing or have suggestions, please open an issue to discuss.

## License

This project will be licensed under the MIT License. Details will be provided as the project matures.
piperbook 2023.9.24
Uses piper-tts to convert epub files to audiobooks
Requires Python: >=3.11

# PiperBook

Converts an epub to a directory of mp3s using [piper-tts](https://pypi.org/project/piper-tts/).

```bash
$ piperbook -s 1.0 -p 0.5 -v "en_US-ryan-high" test.epub author/test
19:55:27	MainThread	Chapters count: 5.
19:55:27	MainThread	Converting chapters 1 to 5.
19:55:35	worker-0	[✓] Wrote file 1_test_epub.mp3
19:55:39	worker-1	[✓] Wrote file 2_test_epub.mp3
19:58:12	worker-1  [✓] Wrote file 3_test_epub.mp3
19:59:27	worker-0	[✓] Wrote file 4_test_epub.mp3
20:00:54	worker-1	[✓] Wrote file 5_test_epub.mp3
20:00:56	MainThread	Cleaned up 0 from cache.
```

Supports voices models as listed on the [piper Readme](https://github.com/rhasspy/piper)


## Usage

```
usage: piperbook [-h] [--start START] [--end END] [-s SPEED] [-v VOICE] [-p PAUSE] [-c] [-j PROCESSES] epub audiobook-folder

Convert epub file to audiobook directory of mp3s

positional arguments:
  epub                  Epub file
  audiobook-folder      Destination folder for the mp3 files

options:
  -h, --help            show this help message and exit
  --start START         chapter to start from [default: 1]
  --end END             chapter to finish at [default: -1]
  -s SPEED, --speed SPEED
                        speed of the generated audio (lower is faster!) [default: 1.0]
  -v VOICE, --voice VOICE
                        voice to use for the generated audio. To see valid options, see the docs for piper [default: en_US-ryan-high]
  -p PAUSE, --pause PAUSE
                        length of pauses between sentences [default: 0.5]
  -c, --clobber         overwrite existing files [default: False]
  -j PROCESSES, --processes PROCESSES
                        number of piper processes to use. Keep this value low--piper is threaded already. [default: 2]
```

## Installation

Tested on Debian 12.

```bash
$ apt install python python-pip ffmpeg
$ pip install piperbook
$ piperbook --help
```

## Bugs

Chapter detection and naming is very imperfect. Patches welcome.


## TODO

- m4b format support.
- Use piper more intelligently


## Credit

Epub chapterising logic stolen from [epub_to_audiobook](https://github.com/p0n1/epub_to_audiobook).