Quick Start

Get Alice running and responding to messages in 5 minutes.

Prerequisites

  • Node.js (for npm install) or Go 1.25+ (for source build)
  • A Feishu app with bot capability and long connection enabled
  • At least one LLM CLI installed and authenticated:

If you haven't set up your Feishu app yet, follow the Feishu Platform Setup tutorial first.

Step 1: Install

Via npm (recommended):

npm install -g @alice_space/alice

Via installer script:

curl -fsSL https://cdn.jsdelivr.net/gh/Alice-space/alice@main/scripts/alice-installer.sh | bash -s -- install

From source:

git clone https://github.com/Alice-space/alice.git
cd alice
go build -o bin/alice ./cmd/connector

Step 2: Setup

alice setup

This creates the directory structure at ~/.alice/, writes a default config.yaml, syncs bundled skills, and (on Linux) registers a systemd user unit.

Step 3: Configure

Edit ~/.alice/config.yaml and fill in at minimum:

bots:
  my_bot:
    name: "Alice"
    feishu_app_id: "cli_xxxxxxxx"      # from Feishu Open Platform
    feishu_app_secret: "your_secret"    # from Feishu Open Platform
    llm_profiles:
      chat:
        provider: "opencode"
        model: "deepseek/deepseek-v4-flash"
      work:
        provider: "opencode"
        model: "deepseek/deepseek-v4-pro"

The default config ships with OpenCode profiles targeting DeepSeek models. If you use a different LLM CLI, see Configure LLM Backends.

Step 4: Verify Backend Auth

Make sure your LLM CLI can authenticate:

opencode --version    # or codex, claude, etc.

Step 5: Start

alice --feishu-websocket

You should see log output indicating the Feishu WebSocket connection and per-bot runtime initialization.

Step 6: Test with Work Mode

Most people use Alice for work mode — task-oriented engineering, debugging, and automation. Here's how:

In any Feishu group chat where your bot is present:

@Alice #work fix the login timeout in auth.go

What happens:

  1. Alice creates a Feishu thread for this task
  2. Starts the configured LLM backend (e.g. DeepSeek V4)
  3. Streams progress and tool calls back to the thread
  4. The session is persisted — you can resume from your terminal later

Try the built-in commands too:

/help       — Show command list
/status     — Show current session and backend info
/stop       — Cancel the running task

Chat Mode (Casual)

Alice also supports a casual chat mode where the bot behaves like a persistent group participant. Just message with @Alice:

@Alice what's the weather like?

Chat mode uses the chat LLM profile (lighter model), shares one session per group, and doesn't create threads. Use /clear to reset the chat session.

Tip: The default config.example.yaml enables both modes. Work mode is the primary use case for most operators. If you only need work mode, set group_scenes.chat.enabled: false.

What's Next?