Issues with developer instructions

[cmoulliard]

Issue

I try to build/run kai as documented here: https://github.com/konveyor/kai/blob/main/docs/contrib/dev_environment.md
and discovering different issues:

1. make build-binaries

make build-binaries
cd kai_analyzer_rpc && go build -o kai-analyzer main.go
cp kai_analyzer_rpc/kai-analyzer dist/kai-analyzer-rpc
cp: dist/kai-analyzer-rpc: No such file or directory

The "dist" folder should be created before to run the command or makefile adapted

2. make build-kai-rpc-server

pyinstaller --clean build/build.spec
make: pyinstaller: No such file or directory
make: *** [build-kai-rpc-server] Error 1

pyinstaller should be defined part of the dependencies declaration file

3. make run-server fails

❯ make run-server
bash -c 'set -m; _trap () { kill -15 $PID; } ; trap _trap SIGINT ;\
        if [[ "$(uname)" -eq "Darwin" ]] ; then export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES ; fi ;\
        PYTHONPATH="/Users/cmoullia/code/application-modernisation/konveyor/kai/kai:" python kai/server.py & export PID=$! ;\
        while kill -0 $PID > /dev/null 2>&1; do wait $PID; done'
/opt/homebrew/Cellar/python@3.13/3.13.7/Frameworks/Python.framework/Versions/3.13/Resources/Python.app/Contents/MacOS/Python: can't open file '/Users/cmoullia/code/application-modernisation/konveyor/kai/kai/server.py': [Errno 2] No such file or directory

[jwmatthews]

@cmoulliard thank you for the issue and apologies on the headache with our docs being out of date.

The majority of the "Konveyor AI" functionality has been merged into the VSCode extension for Konveyor at:
https://github.com/konveyor/editor-extensions

I recommend checking out the "konveyor/editor-extensions" repo to see the bulk of Konveyor AI capabilities.

In this specific repo there are only 2 components that are still being used:

• https://github.com/konveyor/kai/tree/main/kai_analyzer_rpc (a small shim to allow the analyzer-lsp rules engine to use the language provider from the IDE)
• https://github.com/konveyor/kai/tree/main/kai_mcp_solution_server (a MCP server that creates a memory of prior code suggestions and works with a LLM to generate improved hints for future fixes)

Work items remaining for this issue:

• Update docs to clearly call out what code is "active" and what is older/archived
• Consider moving the older, no longer used code to an "archived" directory or just delete
• Update docs to be clearer on pointing folks to https://github.com/konveyor/editor-extensions