Skip to content

Commit cf3fd9d

Browse files
antmikinkaclaude
andcommitted
docs(readme): add Linux/Ubuntu badge, dev:linux command, and Linux notes
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 867bd46 commit cf3fd9d

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

README.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
<p align="center">
44
<img src="https://img.shields.io/badge/Windows-x64-0078D6?logo=windows&logoColor=white" alt="Windows" />
5+
<img src="https://img.shields.io/badge/Linux-Ubuntu-E95420?logo=ubuntu&logoColor=white" alt="Linux/Ubuntu" />
56
<img src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white" alt="Node.js 20+" />
67
<a href="https://github.com/lemonade-sdk/interviewer/blob/main/LICENSE">
78
<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
@@ -55,9 +56,12 @@ Follow the [Lemonade Server installation guide](https://github.com/lemonade-sdk/
5556
### Development Mode
5657

5758
```bash
58-
# Start the development server (React + Electron)
59+
# Windows / macOS
5960
npm run dev
6061

62+
# Linux / Ubuntu
63+
npm run dev:linux
64+
6165
# In a separate terminal, ensure Lemonade Server is running
6266
lemonade-server
6367
```
@@ -194,6 +198,14 @@ interviewer/
194198
└─────────────────┘
195199
```
196200

201+
## Linux / Ubuntu Notes
202+
203+
The app runs on Ubuntu out of the box. A few things to be aware of:
204+
205+
- Use `npm run dev:linux` instead of `npm run dev` — this passes the required `--no-sandbox` flag to Electron, bypassing the SUID sandbox requirement that causes a crash on most Linux setups.
206+
- The default model (`Qwen3-Coder-30B-A3B-Instruct-GGUF`) is set automatically. If you previously ran an older version that saved a different model name (e.g. `gpt-oss-mxp4`), the app will auto-correct it on next startup.
207+
- For packaged AppImage builds, no extra flags are needed — the sandbox is handled at the app level.
208+
197209
## Contributing
198210

199211
1. Fork the repository

0 commit comments

Comments
 (0)