First off I want to commend you on such awesome work! Kartograph is great.
Just a quick point, the API reference needs updating. For example on the first page it says you can run it from command line this way : kartograph config.json -o map.svg
Though it is missing an 'svg' between the kartograph and config.json.
It is also very confusing and if possible test items such as shape files coud be included, it would be great.