Skip to main content

Pikachu interpreter written in Python

Project description

Pikachu Interpreter

This is an interpreter for Pikachu for Python 2.7.x

The definition of the esoteric programming language named 'pikachu' can be found here. This is built as a cleaner version of


  1. Run $ pip install pikapy

  2. Go to your Sublime Packages folder, which defaults to ~/Library/Application Support/Sublime Text 3/Packages on Mac OSX and on Windows, create a new folder called Pikachu, and copy pikachu.sublime-syntax to there.

  3. In the same Packages folder, find Color Scheme - Default, and copy pikachu.sublime-color-scheme there.

  4. In Sublime Text, go to Preferences → Color Scheme, and select Pikachu.


In the command line, go to the installation directory, and run:

$ pikachu <pikachu filename> [arguments*]

Pikachu Language

In Pikachu, you have two Pikachus (i.e. stacks): pi pikachu and pika pikachu. Upon starting a Pikachu script, the arguments are pushed into pi pikachu in the order they're given.

Pikachu Syntax

Arithmetic Operations
  • pi pika <PIKACHU> - add the top two values in the given Pikachu, and push the sum to the same Pikachu
  • pika pi <PIKACHU> - subtract the top value in the Pikachu from the second top, then push the difference
  • pi pikachu <PIKACHU> - multiply the top two values in the Pikachu, and push the product
  • pikachu <PIKACHU> - divide the second-from-the-top value in the Pikachu by the top value, then push the product
Stack Operations
  • pika pikachu <PIKACHU> - pop the top value from the Pikachu, and print as a number
  • pikachu pikachu <PIKACHU> - pop the top value from the Pikachu, and print as ASCII
  • <PIKACHU> - pop the top value from the Pikachu
  • <n terms> <PIKACHU> - push n into the PIkachu
  • <pi pika> - push the top value of pika pikachu into pi pikachu
  • <pika pi> - push the top value of pi pikachu into pika pikachu
Control Operations
  • pikachu pikachu - if the top values of both Pikachus are equal, goto line n, where n is the number of terms in the following line
  • pika pika - if the top values of both Pikachus are not equal, goto line n, where n is the number of terms in the following line

Note: Pikachus start counting lines from 1, not 0

Other Options
  • pi pi - push to pika pikachu a random number between 1 and n, where n is the top value in pika pikachu
  • chu - anything that comes after a chu, is treated as a comment, and will be ignored by the interpreter. This includes any line beginning with the word chu.

Note: Things in this section are not part of the original definition of the language, rather features added for the convenience of the programming Pikachus

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pikapy, version 0.5
Filename, size File type Python version Upload date Hashes
Filename, size pikapy-0.5-py2-none-any.whl (7.5 kB) File type Wheel Python version py2 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page