Skip to content

Development

Set up

git clone https://github.com/Rayjk123/Keel.git
cd Keel
nvm use
npm install

npm install only fetches TypeScript for the type check. Keel itself has no dependencies.

Test and type-check

npm run typecheck
npm test

The tests run the real agent loop against a scripted fake model, so they finish in under a second and need no model or network. They cover finishing a task, step limits, bad replies, history, reply parsing and command execution.

Both commands also run on every push and pull request through GitHub Actions.

Project layout

agent.ts                the whole agent
test/                   tests for the loop, adapter and command runner
bench/keel_agent.py     plugs Keel into Harbor for benchmarking
bench/swebench_lite.py  runs and grades SWE-bench Lite
bedrock/                optional proxy for AWS Bedrock
docs/                   this documentation site

Preview the docs

pip install -r requirements-docs.txt
mkdocs serve

Then open http://127.0.0.1:8000.

License

Keel is released under the MIT License.