Quick Start

Make sure you've installed nodejs first

• Linux, Mac OS:

$ curl -sL https://deb.nodesource.com/setup_10.x | bash -
$ apt-get install nodejs -y

• Windows: https://nodejs.org/en/download/

With pip

$ pip install JavPy

# or download the JavPy whl release in the release page
$ pip install JavPy-x.x.x-py2.py3-none-any.whl

then

$ javpy

or alternatively,

$ python -c "import JavPy; JavPy.serve()"

and wait up to 5 secs

With Docker

$ docker pull wheatcarrier/javpy:latest

then

$ docker run -p 8081:8081 wheatcarrier/javpy:latest

open http://localhost:8081 in explorer and enjoy driving!

With Git

$ git clone https://github.com/TheodoreKrypton/JavPy.git
$ cd JavPy
$ python3 setup.py install
$ javpy

and wait up to 5 secs to start driving

Indicator	Status
Ubuntu & Mac OS
Windows
Coverage
pypi
Docker
Discussion

简介/Introduction

这是一个用来搜索日本 AV 相关信息的 Python 库，目前提供 2 种用户接口，一个为移动设备服务的 telegram bot，和一个为桌面个人电脑服务的 web 页面。

这个 Python 库从多个网站爬取信息，但多数目标网站在一些特定地区都被禁止访问。为了更好的使用体验，建议将这个库运行在互联网管制较少的地区，如美国，日本等。

总而言之，有三个要点：

1. 这个库用来搜索日本 AV
2. 这个库提供两个接口：telegram bot 和 web
3. 如果网络环境不好，请使用 VPN

This is a Python library for searching Japanese AVs related information. This project temporarily provides both a telegram bot and a locally hosted web page, correspondingly for mobile users and for PC users as interfaces.

This library fetches information from various websites, but most of them are blocked in some regions. To experience a better travel, please host the service in somewhere having lesser Internet restrictions, like the USA, Japan, etc.

In brief, there are 3 main instructions concluded below.

1. It is for searching Japanese AVs.
2. It provides 2 interfaces: telegram bot and web.
3. Use VPN if you experience network issues.

Web

Configuration

ip-whitelist and password

如果你将服务部署在一个远程机器，像是云虚拟专用服务器上，你可能会担心网站被其他未经许可的人访问。在0.2.5发布版后，JavPy会自动创建一个配置文件~/.JavPy/config.json。你可以将你的私人ip或ip段添加到文件中，并创建一个密码。未被认证的访问将被拦截并得到一个400错误响应。你也可以在页面右上角的设置按钮配置选项。

If you want to run the server on a remote machine like a cloud VPS, you may be worry about the website being accessed by unauthorised people. After release 0.2.5, JavPy will automatically create a configuration file ~/.JavPy/config.json on its first run. You can add your personal IPs or IP ranges into the file and create a password. Unauthorised access will then be blocked and get a response of Error 400. You can also set the configuration with the settings button on the top right of tha web page.

proxy

如果你需要使用代理，请在~/.JavPy/config.json中设置proxy这一项，目前可以支持socks5与http代理

例子：proxy: "http://127.0.0.1:1080"

If you need to use a proxy, simply set the proxy field in the ~/.JavPy/config.json. Currently both socks5 and http proxies are supported.

Example: proxy: "http://127.0.0.1:1080"

Contributor Guide

$ git clone https://github.com/TheodoreKrypton/JavPy.git

Backend:

$ pip3 install -r requirements.txt
$ python3 main.py

Frontend:

$ cd JavPy/app/web
$ npm install

Modify the port to 8081 in config.js when debugging and make sure you have recovered it before releasing.

$ npm run serve

Telegram Bot

Demo

https://t.me/JavExpert_bot (TEMPORARILY SHUTDOWN)

Supported Commands

• /start guided jav trip
• /search [code]
• /search [actress name] --many-actresses [allow/denied] -upto 20
• /new [--many-actresses] [allow/denied] -upto 20
• /brief [code]
• /magnet [code]

Quick Start

• Go to the telegram bot father and apply for a bot token
• Clone this repo and create a new file named "token.txt"
• Copy your bot token into the "token.txt"

from JavPy.app.tgbot.server import run

run(open("token.txt").read())