Skip to content

Develop keel v2

Milimarty edited this page Oct 19, 2026 · 2 revisions

Develop keel v2

Part Tech Run Tests
engine/ Python 3.12, FastAPI, LangGraph, LangChain, MCP uv run keel-engine (:8090) uv run pytest
api/ Kotlin, Spring Boot 3, SQLite, Flyway ./gradlew bootRun (:8080) ./gradlew test
web/ React, TypeScript, Vite npm run dev (:5173) npm test
cli/ keel TUI: TypeScript, Ink, esbuild npm run build, then KEEL_TUI_JS=cli/dist/keel-tui.mjs keel2 tui npm test

How the parts talk: CONTRACT.md.

docker build -t keel-v2 .                                 # everything is installed in the image
docker build --build-arg INSTALL_CLIS=0 -t keel-v2:slim . # without the agent CLIs
npx -y -p playwright@1 node docs/gif/record.js            # record the README's GIF from a running keel
scripts/no-v1.sh                                          # lists anything that still depends on keel v1 (CI: 0)

A version tag (v*) builds amd64 + arm64 images (on GitHub's Intel and ARM machines at the same time) and pushes them to ghcr.io/miladnalbandi/keel-v2 (and to Docker Hub when the DOCKERHUB_USERNAME and DOCKERHUB_TOKEN secrets are set). Dependabot (.github/dependabot.yml) opens a pull request every week for each part's dependencies, the Docker base images and the GitHub Actions.


From docs/GUIDE.md · All pages

Clone this wiki locally