{"id":51060241,"url":"https://github.com/yazelin/linebot-ai-starter","last_synced_at":"2026-06-23T01:02:11.209Z","repository":{"id":361917229,"uuid":"1256347860","full_name":"yazelin/linebot-ai-starter","owner":"yazelin","description":"Starter template for LINE Messaging API bots with AI provider adapters and FastAPI webhook deployment.","archived":false,"fork":false,"pushed_at":"2026-06-10T10:48:28.000Z","size":380,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T12:22:06.621Z","etag":null,"topics":["ai-agent","fastapi","line-bot","llm","starter-template"],"latest_commit_sha":null,"homepage":"https://yazelin.github.io/linebot-ai-starter/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yazelin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-01T17:35:13.000Z","updated_at":"2026-06-10T10:48:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yazelin/linebot-ai-starter","commit_stats":null,"previous_names":["yazelin/linebot-ai-starter"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/yazelin/linebot-ai-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yazelin%2Flinebot-ai-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yazelin%2Flinebot-ai-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yazelin%2Flinebot-ai-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yazelin%2Flinebot-ai-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yazelin","download_url":"https://codeload.github.com/yazelin/linebot-ai-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yazelin%2Flinebot-ai-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34671045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","fastapi","line-bot","llm","starter-template"],"created_at":"2026-06-23T01:02:09.076Z","updated_at":"2026-06-23T01:02:11.185Z","avatar_url":"https://github.com/yazelin.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Brand banner](assets/banner.svg)\n\n# LINE Bot AI Starter\n\nA minimal LINE Messaging API bot with AI provider adapters.\n\n## 繁中定位\n\n**LINE Bot AI 入門模板** 面向台灣繁中受眾。\n\n- 主要受眾：適合想用 LINE 做客服、訂單、點餐、內部通知或群組助理的台灣團隊。\n- 核心承諾：把 LINE 官方帳號或群組變成可接 AI、可接資料、可部署的工作流入口。\n- CTA 頁：https://yazelin.github.io/linebot-ai-starter/\n\n\n\n## 公開教學文件\n\n這個 repo 的教學內容直接公開，讓你可以先自己照著跑；如果需要手把手 debug、改成你的公司或個人場景，再考慮工作坊或顧問協助。\n\n- 網頁版教學：https://yazelin.github.io/linebot-ai-starter/tutorial.html\n- Markdown 教學：[`docs/`](docs/)\n- 快速開始：[`docs/01-quickstart.md`](docs/01-quickstart.md)\n- 常見踩雷：[`docs/05-common-pitfalls.md`](docs/05-common-pitfalls.md)\n- 後半段(SDK 對照組):docs/08-line-bot-sdk-comparison.md\n\n## Who this is for\n\nTeams in Taiwan/Japan that want LINE-based AI workflow assistants.\n\n## Features\n\n- FastAPI LINE webhook\n- Signature verification\n- Echo / Claude CLI / Gemini CLI / HTTP providers\n- Docker-ready\n- 官方 line-bot-sdk 版同功能重寫(optional `sdk` extra)— 見 `docs/08-line-bot-sdk-comparison.md`\n\n## Quick start\n\n本專案用 [uv](https://docs.astral.sh/uv/) 管理依賴與虛擬環境（pyproject.toml + uv.lock）。\n\n先安裝 uv（一次就好）：\n\nUbuntu / macOS：\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nWindows（PowerShell）：\n\n```powershell\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n裝完重開終端機，`uv --version` 印得出版本就 OK。\n\n取得專案、裝依賴、跑起來（以下 `uv sync` / `uv run` 在 Ubuntu 與 Windows 完全相同）：\n\n```bash\ngit clone https://github.com/yazelin/linebot-ai-starter.git\ncd linebot-ai-starter\nuv sync\nuv run uvicorn app.main:app --reload --port 8000\n```\n\n`uv sync` 會依 pyproject.toml + uv.lock 自動建立 `.venv` 並裝好套件（毋須手動 venv/activate）；`uv run` 直接在那個環境裡執行。加新套件用 `uv add \u003c套件\u003e`。\n\n\u003e 沒裝 uv 的話 `pip install .` 也能裝，但本教學以 uv 為主。\n\n### 後半段:官方 SDK 版(對照組)\n\n```bash\nuv sync --extra sdk\nPYTHONPATH=. LINEBOT_SMOKE_TARGET=app.main_sdk uv run python parity_smoke_test.py  # 同一份測試也過\nuv run uvicorn app.main_sdk:app   # 啟動 SDK 版\n```\n\nSee the source files and `.env.example` for the minimal runnable path.\n\n## Learn / get help\n\nThis repo is also a CTA page for workshops and consulting:\n\n- GitHub Pages: https://yazelin.github.io/linebot-ai-starter/\n- Contact: yazelin@ching-tech.com\n\n## License\n\nMIT\n\n\n## Brand / CTA design\n\n- Landing page: https://yazelin.github.io/linebot-ai-starter/\n- CI spec: [DESIGN.md](DESIGN.md)\n- Banner: [assets/banner.svg](assets/banner.svg)\n- Logo: [assets/logo.svg](assets/logo.svg)\n\n\n---\n## 關於作者\n\n這個範本由 **林亞澤（Yaze Lin）** 維護 — 出身機電自動化系統整合，現在把同一套工程方法用在 AI 產品上。\n\n- 任職於 **擎添工業 ChingTech**（1984 年成立的機電自動化公司：PLC 程式、機械手臂、AGV 無人搬運、半導體封測／PCB／面板／光學產線整合）。\n- 技術筆記與更多範例：[yazelin.github.io](https://yazelin.github.io) · GitHub [@yazelin](https://github.com/yazelin)\n\n## 從範本到正式產品\n\n\u003e 你正在看的 LINE Bot 範本，正式上線版就是 CTOS-Lite / CT JINN。\n\n如果你想看同樣的想法做成正式、上線中的產品：\n\n- **CTOS** — 企業 AI 工作平台：macOS 風格 Web 桌面、知識庫 RAG 檢索、產業專屬 Agent、LINE Bot 整合，資料留在台灣。[ching-tech.com](https://ching-tech.com) · [品牌站](https://ching-tech.github.io)\n- **CTOS-Lite / CT JINN** — 把公司裝進 LINE 的個人版 AI 助理，加 LINE 即可試用：[@285fjkky](https://line.me/R/ti/p/@285fjkky)\n- **Mori Desktop** — 個人 AI 管家桌面應用（Tauri 2 + Rust + React）：[github.com/yazelin/mori-desktop](https://github.com/yazelin/mori-desktop)\n- **AgentOS** — 跨 CLI 的 agent 治理平台（開發中）\n\n\u003e 想把這個範本落地成你公司的內部系統，或想上一堂從 0 到部署的課？\n\u003e 來信 yazelin@ching-tech.com，或追蹤上面的連結。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyazelin%2Flinebot-ai-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyazelin%2Flinebot-ai-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyazelin%2Flinebot-ai-starter/lists"}