enso/README.md

125 lines
5.2 KiB
Markdown
Raw Normal View History

<p align="center">
2020-03-06 13:09:54 +03:00
<br/>
2020-06-19 15:51:20 +03:00
<a href="http://enso.org">
2020-04-06 14:32:10 +03:00
<img
2020-04-21 23:00:27 +03:00
src="https://user-images.githubusercontent.com/1623053/79905826-22bac080-8417-11ea-82b0-ee015904a485.png"
2020-06-19 15:51:20 +03:00
alt="Enso Language"
2020-04-21 23:00:27 +03:00
width="136"
2020-03-06 13:09:54 +03:00
/>
</a>
<br/>
<br/>
2020-06-19 15:51:20 +03:00
<a href="http://enso.org">
2020-04-06 14:32:10 +03:00
<img
src="https://user-images.githubusercontent.com/1623053/75661125-05664300-5c6d-11ea-9bd3-8a5355db9609.png"
alt="Enso Language"
2020-03-06 13:09:54 +03:00
width="240"
/>
</a>
<br/>
<br/>
<br/>
</p>
2020-03-06 13:09:54 +03:00
2020-04-07 19:52:38 +03:00
### Fluidly Combining Worlds
2020-07-21 15:59:40 +03:00
2020-04-06 14:32:10 +03:00
<p>
2020-06-23 20:22:31 +03:00
<a href="https://github.com/enso-org/enso/actions">
<img src="https://github.com/enso-org/enso/workflows/Engine%20CI/badge.svg"
2020-04-06 14:32:10 +03:00
alt="Actions Status">
</a>
2020-06-23 20:22:31 +03:00
<a href="https://github.com/enso-org/enso/blob/main/LICENSE">
2020-04-06 14:32:10 +03:00
<img src="https://img.shields.io/static/v1?label=Compiler%20License&message=Apache%20v2&color=2ec352&labelColor=2c3239"
alt="License">
</a>
2020-06-23 20:22:31 +03:00
<a href="https://github.com/enso-org/ide/blob/main/LICENSE">
2020-04-06 14:32:10 +03:00
<img src="https://img.shields.io/static/v1?label=GUI%20License&message=AGPL%20v3&color=2ec352&labelColor=2c3239"
alt="License">
</a>
<a href="http://chat.luna-lang.org">
<img src="https://img.shields.io/discord/401396655599124480?label=Chat&color=2ec352&labelColor=2c3239"
alt="Chat">
</a>
</p>
Enso is an open-source, visual language for data science that lets you design,
prototype, develop and refactor any application by connecting visual elements
together. Enso lets you collaborate with your co-workers, interactively
fine-tune parameters, inspect results and visually profile and debug your
2020-04-07 19:52:38 +03:00
programs in real-time, creating a moment where the mind is free to let the body
create.
2020-03-06 13:09:54 +03:00
2020-04-06 14:32:10 +03:00
Enso consists of several sub projects, including the
2020-06-23 20:22:31 +03:00
[Enso Language Compiler](https://github.com/enso-org/enso) and the
[Enso Integrated Development Environment (IDE)](https://github.com/enso-org/ide).
You can also check out the [Enso Website](https://enso.org) for more
2020-04-06 14:32:10 +03:00
information.
This repository contains [Enso Engine](./engine/), which consists of the
compiler, type-checker, runtime and language server. These components implement
Enso the language in its entirety, and are usable in isolation.
2020-04-21 23:00:27 +03:00
2020-04-06 14:32:10 +03:00
### Getting Started
2020-07-21 15:59:40 +03:00
2020-07-03 19:17:01 +03:00
While we currently don't have any official releases of Enso, nightly builds can
be obtained from the
[CI artifacts](https://github.com/enso-org/enso/actions?query=workflow%3A%22Engine+CI%22).
For more information on how to run these, please refer to the documentation on
[getting Enso](./docs/getting-enso.md).
If you want to read more about the internals of Enso, please take a look at the
developer documentation rendered [here](https://dev.enso.org), or in the
repository [here](./docs).
2020-04-21 23:00:27 +03:00
2020-04-06 14:32:10 +03:00
### Building
2020-07-21 15:59:40 +03:00
2020-04-06 14:32:10 +03:00
The project builds on any platform where [GraalVM](https://graalvm.org) can run.
You will need the source code, and [`sbt`](https://www.scala-sbt.org/). For more
information, please read the detailed instructions in
[CONTRIBUTING.md](./docs/CONTRIBUTING.md).
2020-04-21 23:00:27 +03:00
### Enso's Design
2020-07-21 15:59:40 +03:00
If you would like to gain a better understanding of the principles on which Enso
2020-03-06 13:09:54 +03:00
is based, or just delve into the why's and what's of Enso's design, please take
a look in the [`docs/` folder](./docs/). It is split up into subfolders for each
component of Enso. You can view this same documentation in a rendered form at
[the developer docs website](https://dev.enso.org).
This folder also contains a document on Enso's
[design philosophy](./docs/enso-philosophy.md), that details the thought process
that we use when contemplating changes or additions to the language.
This documentation will evolve as Enso does, both to help newcomers to the
project understand the reasoning behind the code, but also to act as a record of
the decisions that have been made through Enso's evolution.
### License
2020-07-21 15:59:40 +03:00
This repository is licensed under the
[Apache 2.0](https://opensource.org/licenses/apache-2.0), as specified in the
[LICENSE](https://github.com/enso-org/enso/blob/main/LICENSE) file.
2020-04-06 14:32:10 +03:00
This license set was choosen to both provide you with a complete freedom to use
Enso, create libraries, and release them under any license of your choice, while
also allowing us to release commercial products on top of the platform,
including Enso Cloud and Enso Enterprise server managers.
### Contributing to Enso
2020-07-21 15:59:40 +03:00
2020-04-06 14:32:10 +03:00
Enso is a community-driven open source project which is and will always be open
and free to use. We are committed to a fully transparent development process and
highly appreciate every contribution. If you love the vision behind Enso and you
want to redefine the data processing world, join us and help us track down bugs,
implement new features, improve the documentation or spread the word!
If you'd like to help us make this vision a reality, please feel free to join
our [chat](http://chat.luna-lang.org/), and take a look at our
[development and contribution guidelines](./docs/CONTRIBUTING.md). The latter
describes all the ways in which you can help out with the project, as well as
provides detailed instructions for building and hacking on Enso.
2020-07-21 15:59:40 +03:00
If you believe that you have found a security vulnerability in Enso, or that you
have a bug report that poses a security risk to Enso's users, please take a look
at our [security guidelines](./docs/SECURITY.md) for a course of action.