Quick Install¶
Prerequisites¶
- Node.js 18+ — see Appendix: Environment Setup
- OneBot V11 Server — Any QQ access service supporting the OneBot V11 protocol (e.g. NapCat, LLOneBot), see Appendix: Environment Setup
- LLM API Key — at least one LLM provider API Key
Script Install (Recommended)¶
The script automatically checks and installs the Node.js environment. It also latency-tests and picks the fastest Node.js / npm mirror automatically.
curl -fsSL https://raw.githubusercontent.com/spcookie/erii-distribution/refs/heads/master/scripts/install.sh | bash
irm https://raw.githubusercontent.com/spcookie/erii-distribution/refs/heads/master/scripts/install.ps1 | iex
curl -fsSL https://raw.giteeusercontent.com/spcookie/erii-distribution/raw/master/scripts/install.sh | bash
irm https://raw.giteeusercontent.com/spcookie/erii-distribution/raw/master/scripts/install.ps1 | iex
Users in mainland China
If GitHub is slow, use the "China mirror" tabs backed by Gitee. The script itself also latency-tests and prefers domestic mirrors when downloading Node.js and installing npm packages.
Global Install¶
If you already have Node.js installed:
npm install -g erii-bot
erii setup
Project Create¶
Create an erii sub-project within an existing project, suitable for advanced users needing custom project structures. Supports multiple package managers:
npm create erii-bot
pnpm create erii-bot
yarn create erii-bot
bun create erii-bot
After installation, enter the project directory:
cd erii
Initial Setup¶
After installation, run the interactive configuration wizard:
erii setup
The wizard guides you through AI model selection, optional tools, QQ connection, and group configuration.
Upon completion, conf/application.conf and conf/.env.local are generated.