Skip to content

Revise EchoKit firmware flashing and configuration steps #137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alabulei1 merged 1 commit into from
Feb 26, 2026
Merged

Revise EchoKit firmware flashing and configuration steps #137

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 19 additions & 20 deletions doc/docs/use-cases/claude-code.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,21 @@ ECHOKIT_WORKING_PATH="/path/to/your/workspace" target/release/echokit_cc -c ./ru

The echokit_pty server starts automatically and listens on `ws://localhost:3000/ws`.

### Step 2: Configure EchoKit Server
### Step 2: Flash the EchoKit Firmware for Claude Code

Flash your EchoKit device with the latest firmware. Make sure you have the `espflash` tool installed following [the Use a command line tool to flash article](https://echokit.dev/docs/hardware/flash-firmware#3-use-a-command-line-tool-to-flash).

```bash
# get the latest firmware
curl -L -o echokit https://echokit.dev/firmware/echokit_box_claude_code

# Flash the firmware
espflash flash --monitor --flash-size 16mb echokit
```

> The firmware is compatible with the standard EchoKit server. You can still make your EchoKit device a voice AI agent by changing the echokit server config!

### Step 3: Configure EchoKit Server

Add Claude Code configuration to your EchoKit server's `config.toml`:

Expand Down Expand Up @@ -78,9 +92,8 @@ url = "ws://localhost:3000/ws"

For this use case, you still need ASR and TTS services, but you don't need an LLM configuration since Claude Code handles that.

### Step 3: Start EchoKit Server

Launch the EchoKit server with the new configuration:
Then, launch the EchoKit server with the new configuration:

```bash
cd echokit_server
Expand All @@ -89,27 +102,13 @@ cargo run -- --config config.toml

The server will connect to echokit_pty on startup.

### Step 4: Flash EchoKit Firmware

Flash your EchoKit device with the latest firmware:

```bash
# Download and install espflash
cargo install espflash

# Flash the firmware
espflash /path/to/firmware.bin
```

> The firmware is compatible with the standard EchoKit server. You can use your existing EchoKit device!

### Step 5: Connect and Test
### Step 4: Connect and Test

Your EchoKit device will automatically connect to the EchoKit server. Try a voice command:
Next, go to [the setup page](https://echokit.dev/setup/) to connect the EchoKit device to the EchoKit server. Once, it's successful, try a voice command:

> **"Create a web page for me"**

EchoKit will send your command to Claude Code, which executes it and speaks back the results.
That's it. EchoKit will send your command to Claude Code, which executes it and speaks back the results.


## Next Steps
Expand Down
Loading