Skulpt is a Javascript implementation of the Python programming language
JavaScript HTML Python CSS C Shell
Latest commit c140150 Feb 18, 2017 @rixner rixner committed on GitHub Merge pull request #671 from albertjan/reserved-words-attr
fix reserved words in get and set attr
Failed to load latest commit information.
debugger add explicit return when temp breakpoints are hit May 16, 2016
doc update repl.js with same regex Sep 28, 2016
example make call from js also work Apr 14, 2015
gen Adds debugger statement. Oct 29, 2014
repl error in repl.js with comments Dec 8, 2016
src unfix reserved words and names in function Feb 18, 2017
support make it possible to have an input fun that takes a prompt Aug 22, 2016
test and an exception message containing something strange Feb 17, 2017
.bowerrc Bower package management. Aug 13, 2013
.gitattributes Add .gitattributes for test outputs May 28, 2015
.gitignore automatically internal python files Aug 1, 2016
.hgignore ignore .idea/xxxx files May 31, 2011
.jscsrc make jscs happy again Jun 2, 2015
.jshintignore ignore compiler files and some other ignores Aug 5, 2014
.jshintrc remove harmony argument for darwin, add Promise to jshintrc Oct 19, 2014
.travis.yml Use `npm run build-min` instead of `npm run build -- -u` Feb 4, 2017 Change Sk.builtin.null.null$ to Sk.builtin.none.none$ Feb 4, 2017 Switch to npm scripts everywhere. Feb 3, 2017
LICENSE update license Aug 4, 2016 Add Python 2 to the required installs. Feb 4, 2017
bower.json make new release May 28, 2016 Use `npm run build-min` instead of `npm run build -- -u` Feb 4, 2017
jsdoc.json Begin documenting seqtype and numtype. Jun 24, 2015
m Make 'm' a script to use locally installed jscs/jshint/jsdoc Sep 9, 2015
package.json Use `npm run build-min` instead of `npm run build -- -u` Feb 4, 2017
skulpt.cmd rename m to Aug 15, 2013 Add dummy 'root' substitution for run_template.html Aug 31, 2016 throw exception at top level of packages Aug 12, 2014

Welcome to Skulpt

Join the chat at

Skulpt is a Javascript implementation of Python 2.x. Python that runs in your browser! Python that runs on your iPad! Its being used several projects including, Interactive Python Textbooks -- You can see skulpt in action there. Try out some turtle graphics examples to see Skulpt in action.

Build Status


Skulpt is the brainchild of Scott Graham. See for some early demos of skulpt in action.

Brad Miller has been shepherding the development since sometime in 2010/2011.

How can I help?

Welcome to the Skulpt developer community! Check out the ideas list below. And then some practical things for getting started after that.

Ideas List

We are coordinating sprints on some of the ideas below, builtins, stdlib, third party modules, and core performance here. We always welcome interested developers becoming Primarily Repsonsible Persons (PRP) for features they're working on.

  1. Expand the skulpt standard library to include more modules from the CPython standard library. So far we have math, random, turtle, time (partial) random (partial) urllib (partial) unittest, image, DOM (partial) and re (partial). Any of the partial modules could be completed, or many other CPython modules could be added. Potential new modules from the standard library include: functools, itertools, collections, datetime, operator, and string. Many of these would be relatively easy projects for a less exeperienced student to take on.

  2. Over time we have had numerous requests for more advanced Python modules to be included in Skulpt. These include, portions of matplotlib, tkinter, and numpy. These are much more challenging because they contain C code in their implementation, but if a reasonable subset could be implemented in Javascript this would make it much easier to directly add many more python modules that rely on these three. In addition, it would allow for skulpt to potentially be used in teaching an even broader set of topics.

  3. Expand and clean up the foreign function API. This API is critical for implementing parts of the standard library.

  4. Currently builtin types (list, tuple, string, etc) are not subclassable. Making the builtins subclassable would eliminate several known bugs in Skulpt.

  5. Implement decorators. This would enable a whole bunch of pure python modules to be added to skulpt, plus allow us to add things like properties in a nice way.

  6. Do a better job of supporting Python3 semantics, but make Python2/Python3 behavior configurable with a single flag. Sk.python3 is already there for this purpose. Another positive step in this direction would be to update our grammar to Python2.7. Updating the grammar would allow us to add set literals, dictionary comprehensions, and other features present in 2.7.x and Python 3.3.x. This would be an excellent project for a student interested in language design, parsing, and the use of abstract syntax trees.

  7. Make fully workable, and expand support for DOM access as part of the standard library.

  8. Expand and improve overall language coverage. Currently Skulpt does an excellent job of meeting the 80/20 rule. We cover the vast majority of the language features used by the 80% (maybe even 90%) of the code. But there are builtins that are not implemented at all, and there are builtins with only partial implementations.

  9. Implement the hooks for a debugger. This may be a half step towards 1 or may be in a completely different direction, but allowing students to debug line by line a program they have written would have some real benefit.

Building Skulpt

Building Skulpt is straightforward:

  1. Clone the repository from GitHub, ideally using your own fork if you're planning on making any contributions
  2. Install node.js and Python 2 (required to run the build scripts)
  3. Install the required dependencies using npm install
  4. Navigate to the repository and run npm run build
  5. The tests should run and you will find skulpt.min.js and skulpt-stdlib.js in the distfolder


There is plenty of work still to do in making improvements to Skulpt. If you would like to contribute

  1. Create a Github account if you don't already have one
  2. Create a Fork of the Skulpt repository -- This will make a clone of the repository in your account. DO NOT clone this one. Once you've made the fork you will clone the forked version in your account to your local machine for development.
  3. Read the HACKING.rst file to get the "lay of the land". If you plan to work on creating a module then you may also find this blog post helpful.
  4. Check the issues list for something to do.
  5. Follow the instructions above to get skulpt building
  6. Fix or add your own features. Commit and push to your forked version of the repository. When everything is tested and ready to be incorporated into the master version...
  7. Make a Pull Request to get your feature(s) added to the main repository.


Check out the mailing list:!forum/skulpt


As time goes on its getting more dangerous to try to acknowledge everyone who has contributed to the project. And, after all, this is git, so their names are all in the historical record. But there are a few to call out.

  • First and foremost to Scott Graham for starting the original project.
  • Bob Lacatena for lots of work on Python longs
  • Charles Severence for bug fixes and the re module.
  • Leszek Swirski and Meredydd Luff for Suspensions
  • Albert-Jan Nijburg for countless bug fixes and process improvements
  • Ben Wheeler for the new and improved turtle module
  • Scott Rixner and students for many bug fixes and improvements
  • Of course, The complete list is here: