Technology moves fast! ⚡ Don't get left behind.🚶 Subscribe to our mailing list to keep up with latest and greatest in open source projects! 🏆

Subscribe to our mailing list


SC:BW Terran AI using JNIBWAPI and Clojure

Subscribe to updates I use korhal

Statistics on korhal

Number of watchers on Github 104
Number of open issues 1
Average time to close an issue 4 days
Main language Scheme
Average time to merge a PR 3 days
Open pull requests 0+
Closed pull requests 1+
Last commit about 5 years ago
Repo Created over 5 years ago
Repo Last Updated about 1 year ago
Size 23.9 MB
Organization / Authorthieman
Page Updated
Do you use korhal? Leave a review!
View korhal activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating korhal for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


Korhal is a Brood War AI written in Clojure on top of a custom fork of JNIBWAPI that we use to extract even more information from the Brood War process. Korhal was started during my time at Hacker School.

Getting Started

A virtual machine image is provided to get you up and running. See the setup page in the wiki.

The wiki also has a decent amount of info about how Korhal works. Check it out before digging in.

Current Status

Korhal is still in early development and is not combat ready. There's a whole lot of work to be done, so get in touch or file an issue if you'd like to contribute!


  • nREPL server for interacting with a running game
  • Brood War API designed for Clojure, ported from JNIBWAPI
  • Fully asynchronous AI using Clojure's awesome ref types
  • Contracts system keeps track of resources that have been committed to actions but not yet spent
  • Can execute build orders given in similar format to how humans write them, e.g. 9 :supply-depot
  • Very basic micro routines, e.g. marines attempt to kite zealots

Example Videos

Marines kiting zealots

Ghosts coordinating lockdowns

Skirmish against zealots and dragoons

Basic build order execution

korhal open issues Ask a question     (View All Issues)
  • over 5 years Separate the AI and the Clojure API
korhal list of languages used
Other projects in Scheme