ZEAL

繁體中文 | English

ZEAL (Zona's Easy Adapter for Lin-bot) helps you quickly create and configure a LINE Bot.

Inspired by Zona, ZEAL aims to help anyone who wants to build a LINE Bot finish the basic setup quickly, so they can spend their time developing the Bot itself.

Before you begin

• Python 3.11 or later
• uv
• A LINE account that can sign in to LINE Business
• An ngrok account and authtoken

Install

Install the published package from PyPI:

uv tool install zeal-builder

To work from the source checkout instead:

git clone https://github.com/stoday/ZEAL.git
cd ZEAL
uv sync

Run

zeal line-bot setup

From the source checkout, use:

uv run zeal line-bot setup

When Playwright Chromium is missing, ZEAL announces and downloads it. On Linux, it also installs required system packages, which may require administrator privileges.

ZEAL explains the steps first and starts after you press Enter. It reports each stage as it runs. Enter account details and choose an industry in the terminal. The LINE browser stays visible, and ZEAL fills the form; you do not enter the same details on the site. A gray veil means ZEAL is working and the page is locked against manual input; a green notice means you can use the page. Complete sign-in, OTP/MFA, and human verification in that browser when LINE asks. ZEAL locks the page again when it resumes and clicks both the initial Create button and the final Finish button automatically. If LINE shows the "Agree to our use of your information" page, ZEAL clicks Agree. If setup stopped before writing .env, rerun the same command with the same details. ZEAL checks for an existing account with that name before continuing the unchanged local project. When setup finishes, the command exits while the Bot and ngrok keep running. The summary shows their PIDs, log paths, and commands to inspect or stop them.

At the end, scan the QR code, send the Bot a message, and confirm the reply. ZEAL disables LINE's default auto-response when it enables the Webhook, so incoming messages receive one Bot reply. Greeting messages remain configurable. ZEAL creates line-bot-<account-name>/; edit app.py there to change the Bot's reply. Keep .env private.

Other commands

# Stop the Bot and ngrok when setup finishes instead of leaving them running
zeal line-bot setup --stop-after-setup

# Set up a local Bot project for an existing LINE Messaging API channel
zeal line-bot resume

# View all available options
zeal line-bot setup --help
zeal line-bot resume --help

# Show the installed ZEAL version
zeal --version

When working from the source checkout, prefix these commands with uv run.

After setup, use LINE Official Account Manager to edit account details and automatic replies. Use the LINE Developers Console to edit the Webhook and Messaging API settings.

For a detailed manual walkthrough in Traditional Chinese, see line-bot-apply.md.