https://github.com/eeriemyxi/ntai
Find random nHentai books based on specified search query. Succesor of Firush.
https://github.com/eeriemyxi/ntai
api nhentai python random search tui web
Last synced: 22 days ago
JSON representation
Find random nHentai books based on specified search query. Succesor of Firush.
- Host: GitHub
- URL: https://github.com/eeriemyxi/ntai
- Owner: eeriemyxi
- License: mit
- Created: 2026-04-06T18:41:01.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-06T20:37:33.000Z (3 months ago)
- Last Synced: 2026-04-06T21:12:39.430Z (3 months ago)
- Topics: api, nhentai, python, random, search, tui, web
- Language: TypeScript
- Homepage:
- Size: 605 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ntai
Ntai is the successor to [Firush](https://github.com/eeriemyxi/firush) that uses
the new [nHentai API](https://nhentai.net/api/v2/docs) instead.
Firush was a tool to find _random_ manga/doujinshi/comics from [nHentai](https://nhentai.net) based on
search queries.
Firush behind the scenes was doing the following:
- Search the query
- Scrape the total page count _k_
- Pick a random number between 1 and _k_
- Scrape and return a random entry from that page.
However, nHentai has now made scraping the site unreliable; thus, Ntai instead
depends on the API for the page count and book information.
# Screenshots
## Web Client
Click to expand additional screenshots
# Installation
> [!NOTE]
> This package exports binaries `ntai` and `myxi-ntai` which are available
> after installation.
## From PyPi
You can install the PyPi package:
```
pip install myxi-ntai
```
> [!TIP]
> You can also use [`uv`](https://docs.astral.sh/uv/getting-started/installation/) like so:
>
> ```
> uv tool install myxi-ntai
> ```
## From Source
> [!IMPORTANT]
> Installation of [Git](https://git-scm.com/) is required.
```
pip install git+https://github.com/eeriemyxi/myxi-ntai.git
```
# How To Use
There are two clients, web and TUI.
To use the web version, simply do:
```
ntai web
```
Or the TUI version:
> [!IMPORTANT]
> The TUI version is yet to be implemented.
```
ntai tui
```
You could also check out `ntai [tui,web] --help` :)
# Command-line Arguments
```
Usage: ntai [OPTIONS] COMMAND [ARGS]...
Options:
-L, --log-level [TRACE|DEBUG|INFO|SUCCESS|WARNING|CRITICAL|ERROR]
-v, -V, --version Show the version and exit.
--help Show this message and exit.
Commands:
tui
web
```