Skip to content
/ pylon Public

Pylon IDE, a Cloud9 v2 descendant with some added extras and support for modern node >= 14.21.1 (v15.x, v16.x, v17.x, v18.x, v19.x, v20.x). OSS licensed.

License

Notifications You must be signed in to change notification settings

pylonide/pylon

Repository files navigation

Build Status Master Dependency Status Development Dependency Status Bitcoin donate button € donate button

Pylon IDE

Pylon is a web based integrated development environment built with Node.js as a backend and with a supercharged JavaScript/HTML5 frontend, licensed under GPL version 3. This project originates from Cloud9 v2 project.

About

Pylon is built entirely on a web stack, making it the most hacker-friendly IDE today. Fork it, hack it, make it your own and if you think others would benefit, file a pull request against development branch in this repo or create an issue. You can run Pylon locally or on a remote server - always ready to be available from wherever you are, assisting you to breathe life into every aspect of your ideas and projects.

Features

  • High performance ACE text editor with bundled syntax highlighting to support a wide range of programming languages.
  • Modern node support (NodeJS >= 14.21.1)
  • Up to date dependencies and compatibility fixes
  • Terminal

Screenshots

Browser used: Safari 12.1.1

Alternative forms based authentication

ScreenShot

Login picture by Annie Spratt - Fog (Unsplash license)

The main user interface

ScreenShot

Additional plugin dockpanel view

ScreenShot

Check out pylonide/pylon-plugin-mungit for the Git plugin.

Browser Support

Modern versions of Chrome and Safari are supported. Firefox, altough functional, no longer works as intended as of version 64.0. In the future, efforts will be made to restore compatibility.

Basic iPad Pro support with keyboard

Efforts have been made to make Pylon usable with iPad. However, for a smoother ride, some keyboard settings needs to be changed:

  • Settings -> General -> Keyboard -> Auto-Correction -> Off
  • Settings -> General -> Keyboard -> Smart Punctuation -> Off (interferes with coding by changing quotes)
  • Settings -> General -> Keyboard -> Shortcuts -> Off (interferes by displaying bottom bar that hides the console prompt)

For quality of life it is recommended to remap Caps Lock hardware key to act as an ESC key:

  • Settings -> General -> Keyboard -> Hardware Keyboard -> Modifier Keys -> Caps Lock Key -> Escape

Installation and Usage

If installing on Windows, please refer to Installation on Windows.

Requirements (>= 2.9.0):

  • NodeJS >= 14.21.1
  • g++-4.9 (Required for node-pty compilation)
  • make (Required for node-pty compilation)
  • python (Required for node-pty compilation)

Install:

git clone https://github.com/pylonide/pylon.git
cd pylon
npm i

The above install steps creates a pylon directory with a bin/pylon.sh script that can be used to start Pylon:

bin/pylon.sh

Optionally, you may specify the directory you'd like to edit:

bin/pylon.sh -w ~/git/myproject

Pylon will be started as a web server on port -p 3131, you can access it by pointing your browser to: http://localhost:3131

By default Pylon will only listen to localhost. To listen to a different IP or hostname, use the -l HOSTNAME flag. If you want to listen to all IP's:

bin/pylon.sh -l 0.0.0.0

If you are listening to all IPs it is advised to add authentication to the IDE. You can either do this by adding a reverse proxy in front of Pylon, or use the built in basic authentication through the --username and --password flags.

bin/pylon.sh --username leuser --password plnisawesome

Pylon is compatible with all connect authentication layers, to implement your own, please see the plugins-server/cloud9.connect.basic-auth plugin on how we added basic authentication.

Installation on Windows (experimental)

If you are on Windows Insider Program, use the Bash on Windows feature to install Pylon.

Install NVM to manage node versions. Install a node version to your liking. The following is needed to install the needed build tools:

sudo apt-get update
sudo apt-get install build-essential

Clone the Pylon repo to your machine and run npm:

npm install
bin/pylon.sh -w . -l 0.0.0.0

Installation inside Docker container

Pylon IDE can be successfully deployed and run within a container. However, if the npm utility complains permissions during install. One must include --unsafe-perm for the installation to pass successfully.

Updating

To update to the latest version (if this doesn't work, just make a fresh clone):

git pull
npm update

Creating your own Plugins

Pylon functionality is all created around server and client-side plugins. However, there is hardly any documentation about the APIs to create your own plugins. To get you started, please see pylonide/pylon-plugin-mungit to see how to get started for a client-side only plugin.

Going forward, there will be efforts made to sort out the documentation and write some tutorials to make it more easier to get started.

License

The GPL v3.

Contributing

Open new issue for discussion and/or feel free to submit a pull request against the development branch.