Skip to main content
This page covers the system requirements, installing QoderWake, signing in and starting the service, and how to create your first Waker and start a conversation.

​
System requirements

ItemRequirement
Operating systemmacOS 13.0+, Linux (Ubuntu 22.04 LTS+), Windows 10+, with a GUI desktop enabled
Memory4GB+ recommended
Disk spaceAt least 500MB of free space
NetworkAccess to external networks required (model APIs, code repositories, etc.); enterprise networks must allow outbound HTTPS access

​
Installation

Open a terminal and run the following command:
curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
The install script automatically completes the following steps:
1

Detect platform and CPU architecture

Identify the current operating system and processor architecture.
2

Download and verify the package

Download and verify the installation package for your platform.
3

Install the main program

Install the main program and resource files.
4

Add to PATH

Add the command entry point to PATH.
5

Account authentication

Launch the browser for account authentication.
6

Start the service

Start the local resident service and open the Web Console.
Headless Linux (no GUI desktop): if the browser can’t open automatically for authentication, sign in with a token manually after installation:
QODER_PERSONAL_ACCESS_TOKEN="pt-xxxx" ~/.qoderwake/qoderwake login --method token
Replace pt-xxxx with your PAT (create one in the Qoder console → Personal Settings → Service Integration → New Token).

​
Sign in and start

The install script handles sign-in and service startup automatically, with no manual action required. Command entry point: 
~/.qoderwake/bin/qoderwake
Default Web Console address: 
http://127.0.0.1:19820/
To control the service lifecycle manually, use the following commands: 
# Manually start the service and open the browser
qodercli start --open

# Check service status
qodercli status

# Stop the service
qodercli stop
In everyday use, you only need to run the install script once on first run; after that, all operations are done in the Web Console.

​
Create your first Waker and start a conversation

1

Create a Waker

On the Web Console home page, click the “Create Waker” button in the top-right corner.
2

Select a template

On the template selection screen, choose a suitable template (such as “Frontend Engineer”).
3

Fill in and save

Enter a name and description, then click “Save” to finish creating.
4

Open the conversation page

Click the “Chat” icon in the left navigation bar to open the conversation page.
5

Select the Waker

Select the Waker you just created from the session list; the conversation area appears below.
6

Start the conversation

Type a message directly in the input box and press Enter or click the send button to start the conversation.
If the service isn’t running, you can restart it and open the browser at any time by running qodercli start --open in the terminal.
For the full Waker creation flow and customization options, see Waker Management.