Copyright 2011-2015 Nicolas Petton
Copyright 2014-2019 Herbert Vojčík and Amber contributors
Try Amber online and learn more on project page.
@ambers/contrib-webwith a canvas to generate HTML, like Seaside, included in a new project by default,
@ambers/silkwith a stream-like wrapping of DOM elements, included in a new project by default,
@ambers/heliosIDE, included in a new project by default,
@ambers/contrib-legacywith smaller in-page "classic" IDE and some miscellany, included in a new project by default,
@ambers/prof-stef, containing Prof Stef interactive crash course.
Amber cli tool to create new projects and assist with development tasks
is in a npm package
Amber engine and core library to be used in projects
is in a npm package
For the installation to work, you need to have installed
node installers may install
npm as well.
git in Windows, use Git for Windows and select "Run Git from Windows Command Prompt" and "Checkout Windows-style, commit Unix-style" installation options.
For UNIX-based OS (Linux distibutions, FreeBSD, ...) do
npm config set prefix=~/npm export PATH="$PATH:$HOME/npm/bin"
to have the installation in a local subdirectory in order to avoid the otherwise necessary
sudo installation of Amber. The export line needs to be added to the ~/.profile file as well so that after a new login the path is set.
Do this to install Amber
# In case you have installed older package `amber-cli`, uninstall it. npm uninstall -g amber-cli # Install the CLI tool `@ambers/cli` and supporting tools npm install -g grunt-cli grunt-init @ambers/cli
amber init to create a project of your own
# Initialize your project (directory must be empty) cd /path/to/myproject amber init
The new project has its own
.gitignore and is ready to use with git as-is.
Eg. just run
git init and your Amber project is under version control.
If you want to run Amber in older environments,
you should install additional polyfills (
is included by default) and link them up in
Amber officially only runs in ES5-compliant environments.
Start developing in Amber Smalltalk
# Serve amber on localhost:4000 amber serve
It must be noted this repo contains only core functionality of Amber system
as well as accompanying tooling (
The initial project comes with some libraries (
included; these libraries are not part of this repo, though. You can find them either in
Amber organization or, for some of them, in their own pages:
Most of Amber discussion and help happens on the Google group
Report issues with the www.amber-lang.net website only here: https://lolg.it/amber/amber-website/issues.
Report issues with the docs.amber-lang.net website only here: https://lolg.it/amber/documentation/issues.
Report issues with Amber engine, core library, as well as with
amberc cli tools here: https://lolg.it/amber/amber/issues.
Report issues with the Helios IDE here: https://lolg.it/amber/helios/issues.
Please refer to CONTRIBUTING.md for further details.
Please refer to CONTRIBUTING.md for further details. It explains the Amber development setup and how to contribute.
Amber is released under the MIT license. All contributions made for inclusion are considered to be under MIT.