https://github.com/tensoraws/yuisub

Auto translation of new anime episodes based on Yui-MHCP001
https://github.com/tensoraws/yuisub

anime chatgpt llm openai pysubs2 subtitle translation whisper

Last synced: 2 months ago
JSON representation

Auto translation of new anime episodes based on Yui-MHCP001

• Host: GitHub
• URL: https://github.com/tensoraws/yuisub
• Owner: TensoRaws
• License: gpl-3.0
• Created: 2024-08-16T16:12:10.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-09-10T13:42:21.000Z (3 months ago)
• Last Synced: 2024-10-09T19:05:24.719Z (2 months ago)
• Topics: anime, chatgpt, llm, openai, pysubs2, subtitle, translation, whisper
• Language: Python
• Homepage:
• Size: 504 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# yuisub

[![codecov](https://codecov.io/gh/TensoRaws/yuisub/branch/main/graph/badge.svg?token=B2TNKYN4O4)](https://codecov.io/gh/TensoRaws/yuisub)

[![CI-test](https://github.com/TensoRaws/yuisub/actions/workflows/CI-test.yml/badge.svg)](https://github.com/TensoRaws/yuisub/actions/workflows/CI-test.yml)

[![Release-pypi](https://github.com/TensoRaws/yuisub/actions/workflows/Release-pypi.yml/badge.svg)](https://github.com/TensoRaws/yuisub/actions/workflows/Release-pypi.yml)

[![PyPI version](https://badge.fury.io/py/yuisub.svg)](https://badge.fury.io/py/yuisub)

![GitHub](https://img.shields.io/github/license/TensoRaws/yuisub)

Auto translation of new anime episodes based on ~~Yui-MHCP001~~ LLM

### Install

Make sure you have Python >= 3.9 installed on your system

```bash

pip install yuisub

```

If you wanna use the `a2t` module, you need to install `Whisper` first

```bash

# pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

pip install openai-whisper

```

### Command Line Usage

`yuisub` can be used from the command line to generate bilingual ASS files. Here's how to use it:

```bash

yuisub -h  # Displays help message

```

### Library

`yuisub` can also be used as a library

### Example

```python3

from yuisub import translate, bilingual, load

from yuisub.a2t import WhisperModel

# sub from audio

model = WhisperModel(name="medium", device="cuda")

sub = model.transcribe(audio="path/to/audio.mp3")

# sub from file

# sub = load("path/to/input.srt")

# generate bilingual subtitle

sub_zh = translate(

    sub=sub,

    model="gpt_model_name",

    api_key="your_openai_api_key",

    base_url="api_url",

    bangumi_url="https://bangumi.tv/subject/424883/"

)

sub_bilingual = bilingual(

    sub_origin=sub,

    sub_zh=sub_zh

)

# save the ASS files

sub_zh.save("path/to/output.zh.ass")

sub_bilingual.save("path/to/output.bilingual.ass")

```

### License

This project is licensed under the BSD 3-Clause - see

the [LICENSE file](https://github.com/TohruskyDev/yuisub/blob/main/LICENSE) for details.