Skip to content

Commit 3567705

Browse files
nthmost-orkesclaude
andcommitted
docs: fix install section for Ubuntu/Debian and correct UI port
- Add venv guidance for Ubuntu 22.04+/Debian 12+ users who hit PEP 668 error when running pip install system-wide (fixes conductor-oss/getting-started#34, conductor-oss/getting-started#35) - Fix quickstart closing paragraph: localhost:8127 → localhost:8080 (fixes conductor-oss/getting-started#40) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent eba99a1 commit 3567705

1 file changed

Lines changed: 9 additions & 1 deletion

File tree

README.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,14 @@ conductor server start
6262
pip install conductor-python
6363
```
6464

65+
> **Ubuntu / Debian users:** Python 3.12+ on Ubuntu 22.04+ and Debian 12+ blocks system-wide `pip install` by default ([PEP 668](https://peps.python.org/pep-0668/)). Use a virtual environment:
66+
>
67+
> ```shell
68+
> python3 -m venv conductor-env
69+
> source conductor-env/bin/activate
70+
> pip install conductor-python
71+
> ```
72+
6573
## 60-Second Quickstart
6674
6775
**Step 1: Create a workflow**
@@ -162,7 +170,7 @@ python quickstart.py
162170
> See [Configuration](#configuration) for details.
163171
164172
That's it — you just defined a worker, built a workflow, and executed it. Open the Conductor UI (default:
165-
[http://localhost:8127](http://localhost:8127)) to see the execution.
173+
[http://localhost:8080](http://localhost:8080)) to see the execution.
166174
167175
---
168176

0 commit comments

Comments
 (0)