app/en/deploy/install.html

44 lines
40 KiB
HTML
Raw Normal View History

<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Install | LiteyukiBot</title>
<meta name="description" content="A high-performance, easy-to-use chatbot framework and application">
<meta name="generator" content="VitePress v1.5.0">
<link rel="preload stylesheet" href="/assets/style.Cuh6-l9Q.css" as="style">
<link rel="preload stylesheet" href="/vp-icons.css" as="style">
<script type="module" src="/assets/app.D-3byi-W.js"></script>
<link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/assets/chunks/theme.BDqTXdie.js">
<link rel="modulepreload" href="/assets/chunks/framework.Z6UMW4JZ.js">
<link rel="modulepreload" href="/assets/en_deploy_install.md.-wI-orhr.lean.js">
<link rel="icon" type="image/x-icon" href="favicon.ico">
<link rel="stylesheet" href="https://fonts.font.im/css?family=Cousine:400,400i,700,700i|Poppins:100,100i,200,200i,300,300i,400,400i,500,500i,600,600i,700,700i,800,800i,900,900i">
<script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-2391887b data-v-7b525b60><!--[--><!--]--><!--[--><span tabindex="-1" data-v-7ff92c28></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-7ff92c28> Skip to content </a><!--]--><!----><header class="VPNav" data-v-7b525b60 data-v-baba5cf6><div class="VPNavBar" data-v-baba5cf6 data-v-aca7bf59><div class="wrapper" data-v-aca7bf59><div class="container" data-v-aca7bf59><div class="title" data-v-aca7bf59><div class="VPNavBarTitle has-sidebar" data-v-aca7bf59 data-v-9d985a76><a class="title" href="/en/" data-v-9d985a76><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/liteyuki-dark.svg" alt="LiteyukiBot Logo" data-v-0d8eb823><!--]--><!--[--><img class="VPImage light logo" src="/liteyuki.svg" alt="LiteyukiBot Logo" data-v-0d8eb823><!--]--><!--]--><!--]--><span data-v-9d985a76>LiteyukiBot</span><!--[--><!--]--></a></div></div><div class="content" data-v-aca7bf59><div class="content-body" data-v-aca7bf59><!--[--><!--]--><div class="VPNavBarSearch search" data-v-aca7bf59><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-aca7bf59 data-v-e886fbec><span id="main-nav-aria-label" class="visually-hidden" data-v-e886fbec> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/en/deploy/install.html" tabindex="0" data-v-e886fbec data-v-73f8baa9><!--[--><span data-v-73f8baa9>Deploy</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/en/usage/basic.html" tabindex="0" data-v-e886fbec data-v-73f8baa9><!--[--><span data-v-73f8baa9>Usage</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/en/store/resource.html" tabindex="0" data-v-e886fbec data-v-73f8baa9><!--[--><span data-v-73f8baa9>Extension</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/en/dev/guide.html" tabindex="0" data-v-e886fbec data-v-73f8baa9><!--[--><span data-v-73f8baa9>Develop</span><!--]--></a><!--]--><!--]--></nav><div class="VPFlyout VPNavBarTranslations translations" data-v-aca7bf59 data-v-20673228 data-v-40a18a3c><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="Language" data-v-40a18a3c><span class="text" data-v-40a18a3c><span class="vpi-languages option-icon" data-v-40a18a3c></span><!----><span class="vpi-chevron-down text-icon" data-v-40a18a3c></span></span></button><div class="menu" data-v-40a18a3c><div class="VPMenu" data-v-40a18a3c data-v-bb193692><!----><!--[--><!--[--><div class="items" data-v-20673228><p class="title" data-v-20673228>English</p><!--[--><div class="VPMenuLink" data-v-20673228 data-v-3d896745><a class="VPLink link" href="/deploy/install.html" data-v-3d896745><!--[--><span data-v-3d896745>简体中文</span><!--]--></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="VPNavBarAppearance appearance" data-v-aca7bf59 data-v-a18085e5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-a18085e5 data-v-bce576c7 data-v-dd82bb1e><span class="check" data-v-dd82bb1e><span class="icon" data-v-dd82bb1e><!--[--><span class="vpi-sun sun" data-v-bce576c7></span><span class="vpi-moon moon" data-v-bce576c7></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-aca7bf59 data-v-18306ed7 data-v-7ec21ccb><!--[--><a class="VPSocialLink no-icon" href="https://github.com/LiteyukiStudio/LiteyukiBot" aria-label="github" target="_blank" rel="noopener" data-v-7ec21ccb data-v-ce68b057><span class="vpi-social-github"></span></a><a class="VPSocialLink no-icon" hr
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/LiteyukiStudio/LiteyukiBot</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --depth=1</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Change directory</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">cd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> LiteyukiBot</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Create virtual environment</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">python</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -m</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> venv</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> venv</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Activate virtual environment</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">.</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">\</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">venv</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">\</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Scripts</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">\</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">activate</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Windows</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> venv/bin/activate</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Linux</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Install dependencies</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pip</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -r</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> requirements.txt</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Run Liteyuki</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">python</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> main.py</span></span></code></pre></div><div class="tip custom-block github-alert"><p class="custom-block-title">TIP</p><p>It is recommended to use a virtual environment to run Liteyuki to avoid dependency conflicts. You can use <code>python -m venv .venv</code> to create a virtual environment, and then use <code>.venv\Scripts\activate</code> to activate the virtual environment (use <code>source .venv/bin/activate</code> to activate on Linux).</p></div><h2 id="run-with-docker" tabindex="-1"><strong>Run with Docker</strong> <a class="header-anchor" href="#run-with-docker" aria-label="Permalink to &quot;**Run with Docker**&quot;"></a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">docker</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> pull</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> git.liteyuki.icu/bot/app:latest</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # Nightly build</span></span></code></pre></div><div class="tip custom-block github-alert"><p class="custom-block-title">TIP</p><p>If you are using Windows, please use the absolute project directory <code>/path/to/LiteyukiBot</code> instead of <code>$&amp;#40;pwd&amp;#41;</code> <br> If you have modified the port number, please replace <code>20216:20216</code> with your port number</p></div><h2 id="device-requirements" tabindex="-1"><strong>Device Requirements</strong> <a class="header-anchor" href="#device-requirements" aria-label="Permalink to &quot;**Device Requirements**&quot;"></a></h2><ul><li>Windows system version minimum <code>Windows10+</code>/<code>Windows Server 2019+</code></li><li>Linux system requires Python3.10+, recommended <code>Ubuntu 20.04+</code></li><li>CPU: at least <code>1vCPU</code></li><li>Memory: Bot without other plugins will occupy <code>300~500MB</code>, including <code>chromium</code> and <code>node</code> processes, other plugins depend on specific plugins, recommended <code>1GB</code> or more</li><li>Disk: at least <code>1GB</code> of space</li></ul><div class="warning custom-block github-alert"><p class="custom-block-title">WARNING</p><p>If there are multiple environments on the device, please use <code>path/to/python -m pip install -r requirements.txt</code> to install dependencies, <code>path/to/python</code> is the path to your Python executable</p></div><div class="warning custom-block github-alert"><p class="custom-block-title">WARNING</p><p>Liteyuki&#39;s update function depends on Git. If you do not have Git installed and run the source code directly, you will not be able to use the update function</p></div><h4 id="for-other-questions-please-refer-to-faq" tabindex="-1">For other questions, please refer to <a href="./fandq.html">FAQ</a> <a class="header-anchor" href="#for-other-questions-please-refer-to-faq" aria-label="Permalink to &quot;For other questions, please refer to [FAQ](./fandq)&quot;"></a></h4></div></div></main><footer class="VPDocFooter" data-v-2c8c6c89 data-v-ba7e2a25><!--[--><!--]--><div class="edit-info" data-v-ba7e2a25><div class="edit-link" data-v-ba7e2a25><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/LiteyukiStudio/LiteyukiBot/tree/main/docs/en/deploy/install.md" target="_blank" rel="noreferrer" data-v-ba7e2a25><!--[--><span class="vpi-square-pen edit-link-icon" data-v-ba7e2a25></span> Edit this page on GitHub<!--]--></a></div><div class="last-updated" data-v-ba7e2a25><p class="VPLastUpdated" data-v-ba7e2a25 data-v-d02c498e>Last updated: <time datetime="2024-12-13T18:57:51.000Z" data-v-d02c498e></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-ba7e2a25><span class="visua
<script>window.__VP_HASH_MAP__=JSON.parse("{\"deploy_config.md\":\"rZ29bwO-\",\"deploy_fandq.md\":\"DTM_Os8N\",\"deploy_install.md\":\"CC2nknrk\",\"dev_api_bot_index.md\":\"BBSYa412\",\"dev_api_bot_lifespan.md\":\"DIiUoNQr\",\"dev_api_comm_channel.md\":\"DfvNcb-v\",\"dev_api_comm_event.md\":\"D22ZPMRO\",\"dev_api_comm_index.md\":\"4xQqkPaL\",\"dev_api_comm_storage.md\":\"BQi3vT-6\",\"dev_api_config.md\":\"B-K0XBnc\",\"dev_api_core_index.md\":\"DDI0LXZQ\",\"dev_api_core_manager.md\":\"mhcXWvCp\",\"dev_api_dev_index.md\":\"CsugCBSr\",\"dev_api_dev_observer.md\":\"CynjhkUR\",\"dev_api_dev_plugin.md\":\"DDM2McYa\",\"dev_api_exception.md\":\"DOgHxE0z\",\"dev_api_index.md\":\"D52Y-HJX\",\"dev_api_log.md\":\"BybOhf50\",\"dev_api_plugin_index.md\":\"DZxV6Tb_\",\"dev_api_plugin_load.md\":\"CoagWwmx\",\"dev_api_plugin_manager.md\":\"CnP65Tni\",\"dev_api_plugin_model.md\":\"BcoMNcwb\",\"dev_api_plugins_index.md\":\"Z4Rsdm03\",\"dev_api_plugins_liteecho.md\":\"N_eRUAPO\",\"dev_api_plugins_plugin_loader_index.md\":\"DWsFMHho\",\"dev_api_session_event.md\":\"BVxh2ZPO\",\"dev_api_session_index.md\":\"DQmAk4eT\",\"dev_api_session_matcher.md\":\"DgoYweUQ\",\"dev_api_session_message_segments.md\":\"DivW-Wd9\",\"dev_api_session_models.md\":\"Bgk7-MSv\",\"dev_api_session_on.md\":\"mdi0h2yr\",\"dev_api_session_rule.md\":\"CDnQtWE_\",\"dev_api_utils.md\":\"eMkV5aFU\",\"dev_best_practices.md\":\"DDTZ-60b\",\"dev_comm.md\":\"CUsgHNWU\",\"dev_guide.md\":\"XHOtYQKj\",\"dev_lyfunc.md\":\"euJSfr5k\",\"dev_plugin.md\":\"BD11oB1J\",\"dev_resource.md\":\"CgE2ak0U\",\"en_deploy_config.md\":\"CN9rndNY\",\"en_deploy_fandq.md\":\"Dv36vALr\",\"en_deploy_install.md\":\"-wI-orhr\",\"en_dev_api_bot_index.md\":\"D-dQtyQd\",\"en_dev_api_bot_lifespan.md\":\"BhXMIeK8\",\"en_dev_api_comm_channel.md\":\"9o4TsTD5\",\"en_dev_api_comm_event.md\":\"B6Ewcgsc\",\"en_dev_api_comm_index.md\":\"D5APenBy\",\"en_dev_api_comm_storage.md\":\"iLOczApS\",\"en_dev_api_config.md\":\"Dx9ofozD\",\"en_dev_api_core_index.md\":\"B0Enriow\",\"en_dev_api_core_manager.md\":\"BxSjacF3\",\"en_dev_api_dev_index.md\":\"C5EYx4Z-\",\"en_dev_api_dev_observer.md\":\"BQeg5dYN\",\"en_dev_api_dev_plugin.md\":\"BdeVORHv\",\"en_dev_api_exception.md\":\"1T6ATWif\",\"en_dev_api_index.md\":\"DXW2vEc5\",\"en_dev_api_log.md\":\"DI2PEAHZ\",\"en_dev_api_plugin_index.md\":\"DmyyE7_n\",\"en_dev_api_plugin_load.md\":\"Czs4uISw\",\"en_dev_api_plugin_manager.md\":\"COXJrHdK\",\"en_dev_api_plugin_model.md\":\"B6LpR1IQ\",\"en_dev_api_plugins_index.md\":\"lmozQLWq\",\"en_dev_api_plugins_liteecho.md\":\"yC9zAc3N\",\"en_dev_api_plugins_plugin_loader_index.md\":\"eXb8XUQw\",\"en_dev_api_session_event.md\":\"BL-c2pAQ\",\"en_dev_api_session_index.md\":\"RGF7O8ai\",\"en_dev_api_session_matcher.md\":\"CRLHKgvR\",\"en_dev_api_session_message_segments.md\":\"2Y-Kb9rZ\",\"en_dev_api_session_models.md\":\"hBDe-9Eh\",\"en_dev_api_session_on.md\":\"CErI_ukT\",\"en_dev_api_session_rule.md\":\"Ba-MhC1J\",\"en_dev_api_utils.md\":\"CH7CaLlN\",\"en_dev_best_practices.md\":\"C6RAozWh\",\"en_dev_comm.md\":\"C0G0EjG1\",\"en_dev_guide.md\":\"On-yqVJy\",\"en_dev_lyfunc.md\":\"CWrlJ86f\",\"en_dev_plugin.md\":\"CmCRS08q\",\"en_dev_resource.md\":\"DF-74BPG\",\"en_index.md\":\"GpQsR9_5\",\"en_store_plugin.md\":\"Bg-9pd5U\",\"en_store_resource.md\":\"B0bKSKzp\",\"en_usage_agreement.md\":\"D5AjvVXP\",\"en_usage_basic.md\":\"D-kabKDv\",\"en_usage_extra.md\":\"qUTomSGE\",\"index.md\":\"CWxOxziL\",\"store_plugin.md\":\"ge6mj8y0\",\"store_resource.md\":\"DfZwuCkq\",\"usage_agreement.md\":\"B4pNiaH-\",\"usage_basic.md\":\"D45R2fPm\",\"usage_extra.md\":\"IMfK8vQA\"}");function deserializeFunctions(r){return Array.isArray(r)?r.map(deserializeFunctions):typeof r=="object"&&r!==null?Object.keys(r).reduce((t,n)=>(t[n]=deserializeFunctions(r[n]),t),{}):typeof r=="string"&&r.startsWith("_vp-fn_")?new Function(`return ${r.slice(7)}`)():r};window.__VP_SITE_DATA__=deserializeFunctions(JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"VitePress\",\"description\":\"A VitePress site\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\
</body>
</html>