Skip to content

docs(python): correct KAgent controller port in package READMEs#1699

Merged
EItanya merged 1 commit intokagent-dev:mainfrom
mesutoezdil:docs/fix-kagent-url-port
Apr 22, 2026
Merged

docs(python): correct KAgent controller port in package READMEs#1699
EItanya merged 1 commit intokagent-dev:mainfrom
mesutoezdil:docs/fix-kagent-url-port

Conversation

@mesutoezdil
Copy link
Copy Markdown
Contributor

@mesutoezdil mesutoezdil commented Apr 19, 2026

The quickstart examples in the kagent-openai and kagent-langgraph READMEs point to localhost:8080 but the controller runs on 8083. Port 8080 is the UI. Anyone copy-pasting those examples gets a connection refused straight away.

Changed all five occurrences across the two files to 8083.

The quickstart examples for the kagent-openai and kagent-langgraph
packages tell users to set kagent_url to http://localhost:8080. The
kagent controller actually listens on 8083 (see helm/kagent/values.yaml
controller.service.ports.port=8083, and the KAGENT_URL=8083 example in
DEVELOPMENT.md). Port 8080 is the UI service. Copy-pasting the current
examples against a port-forwarded controller results in connection
refused errors.

Updating the five occurrences across the two README files to match the
actual controller port.

Signed-off-by: mesutoezdil <mesudozdil@gmail.com>
Copilot AI review requested due to automatic review settings April 19, 2026 19:27
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates Python package READMEs to point quickstart examples at the correct local KAgent controller port (8083), aligning documentation with the Helm chart and existing development/test configuration.

Changes:

  • Update kagent_url in kagent-openai README quickstart and local development snippets from localhost:8080 to localhost:8083
  • Update httpx.AsyncClient(base_url=...) example in kagent-openai README to use localhost:8083
  • Update kagent_url in kagent-langgraph README quickstart from localhost:8080 to localhost:8083

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
python/packages/kagent-openai/README.md Corrects controller connection URLs and the documented KAGENT_URL default to use port 8083
python/packages/kagent-langgraph/README.md Corrects the quickstart controller URL to use port 8083

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@EItanya EItanya merged commit 53f60cc into kagent-dev:main Apr 22, 2026
8 of 9 checks passed
EItanya added a commit that referenced this pull request Apr 22, 2026
Same port issue as #1699 but in the sample READMEs. The crewai and
langgraph samples tell users to set KAGENT_URL=http://localhost:8080
which is the UI port, not the controller. Updated all six occurrences
across the three sample directories to 8083.

---------

Signed-off-by: mesutoezdil <mesudozdil@gmail.com>
Signed-off-by: Eitan Yarmush <eitan.yarmush@solo.io>
Co-authored-by: Eitan Yarmush <eitan.yarmush@solo.io>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants