enso/README.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

269 lines
13 KiB
Markdown
Raw Normal View History

<p align="center">
2021-04-13 19:13:47 +03:00
<a href="https://enso.org">
<img src="https://user-images.githubusercontent.com/1623053/114557275-cbd27a80-9c69-11eb-9e4d-a60187cdb7a4.gif" width="640" height="640"/>
2020-03-06 13:09:54 +03:00
</a>
</p>
2020-03-06 13:09:54 +03:00
2021-02-01 14:01:07 +03:00
<p align="center">
2021-04-13 19:13:47 +03:00
<a href="https://discord.gg/enso">
2021-01-29 15:56:02 +03:00
<img src="https://img.shields.io/discord/401396655599124480.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2"
2021-01-26 20:22:10 +03:00
alt="Chat">
</a>
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>
<a href="https://github.com/enso-org/enso/actions">
<img src="https://github.com/enso-org/enso/workflows/GUI%20CI/badge.svg"
2021-01-28 06:45:03 +03:00
alt="Actions Status">
</a>
<a href="https://github.com/enso-org/enso/blob/develop/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>
<a href="https://github.com/enso-org/enso/blob/develop/app/gui2/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>
</p>
2021-02-01 14:01:07 +03:00
<br/>
2021-04-13 19:13:47 +03:00
# [Enso.org](https://enso.org). Get insights you can rely on. In real time.
Enso is an award-winning interactive programming language with dual visual and
textual representations. It is a tool that spans the entire stack, going from
high-level visualization and communication to the nitty-gritty of backend
2021-04-13 19:13:47 +03:00
services, all in a single language. Watch the following introduction video to
learn what Enso is, and how it helps companies build data workflows in minutes
instead of weeks.
2021-04-15 13:34:17 +03:00
<br/>
<a href="https://www.youtube.com/watch?v=fQvWMoOjmQk" rel="nofollow">
<img width="692" alt="Screenshot 2021-04-15 at 12 16 32" src="https://user-images.githubusercontent.com/1623053/114854125-c8173300-9de4-11eb-9b10-99a331eb2251.png">
</a>
<br/>
2021-04-13 19:13:47 +03:00
<br/>
# Enso's Features
2021-02-01 14:01:07 +03:00
2021-04-13 19:13:47 +03:00
Turning your data into knowledge is slow and error-prone. You cant trust tools
that dont embrace best practices and provide quality assurance. Enso redefines
the way you can work with your data: it is interactive, provides intelligent
assistance, and was designed on a strong mathematical foundation, so you can
always trust the results you get.
2021-01-26 20:22:10 +03:00
2021-04-13 19:34:36 +03:00
<img align="left" width="44px" src="https://raw.githubusercontent.com/enso-org/icons/master/blue/with-bg/it/web-apps-development/001-algorithm.svg">
2021-02-01 14:01:07 +03:00
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>Intelligent suggestions of possible next steps. Build workflows in minutes instead of weeks.</b><br/>
Enso analyses the data, suggests possible next steps, and displays related
help and examples. It lets you build dashboards, RPA workflows, and apps,
with no coding required. Enso ships with a robust set of libraries, allowing
you to work with local files, databases, HTTP services, and other
2021-04-13 19:13:47 +03:00
applications in a seamless fashion.
<br/><a href="https://enso.org">Learn more →<a/>
2021-02-01 14:01:07 +03:00
</ul></ul>
2021-04-13 19:34:36 +03:00
<img align="left" width="44px" src="https://raw.githubusercontent.com/enso-org/icons/master/blue/with-bg/it/badges/018-military.svg">
2021-04-13 19:13:47 +03:00
<ul><ul>
<b>Reproducible, trustworthy results.</b><br/>
Versioning and visual data quality management allow you to trust the results
that you get.
<br/><a href="https://enso.org">Learn more →<a/>
</ul></ul>
2021-04-13 19:34:36 +03:00
<img align="left" width="44px" src="https://raw.githubusercontent.com/enso-org/icons/master/blue/with-bg/it/basic-ui/041-graph.svg">
2021-02-01 14:01:07 +03:00
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>A powerful, purely functional language. Both visual and textual.</b><br/>
Enso incorporates many recent innovations in data processing and programming
language design to allow you to work interactively and trust the results
that you get. It is a purely functional programming language with
higher-order functions, user-defined algebraic datatypes, pattern-matching,
and two equivalent representations that you can switch between on-demand.
<br/><a href="https://enso.org">Learn more →<a/>
2021-02-01 14:01:07 +03:00
</ul></ul>
2021-04-13 19:34:36 +03:00
<img align="left" width="44px" src="https://raw.githubusercontent.com/enso-org/icons/master/blue/with-bg/it/business/036-puzzle.svg">
2021-02-01 14:01:07 +03:00
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>Mix languages with close-to-zero interop overhead.</b><br/>
Import any library from Enso, Java, JavaScript, R, or Python, and use
2021-04-15 13:34:17 +03:00
functions, callbacks, and data types without any wrappers. Enso uses
<a href="https://www.graalvm.org">GraalVM</a> to compile them to the same
instruction set with a unified memory model.
2021-04-13 19:13:47 +03:00
<br/><a href="https://enso.org">Learn more →<a/>
2021-02-01 14:01:07 +03:00
</ul></ul>
2021-04-13 19:34:36 +03:00
<img align="left" width="44px" src="https://raw.githubusercontent.com/enso-org/icons/master/blue/with-bg/it/startup-and-new-business/051-rocket.svg">
2021-02-01 14:01:07 +03:00
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>Fast. Up to 80x faster than Python.</b><br/>
2021-04-15 13:34:17 +03:00
It can even run other languages faster than their official runtimes.
<a href="https://github.com/oracle/fastr">Enso-R (using FastR on the GraalVM)</a>
2021-04-13 19:13:47 +03:00
is 36x faster than GNU-R.
<br/><a href="https://github.com/enso-org/benchmarks">See benchmarks →<a/>
2021-02-01 14:01:07 +03:00
</ul></ul>
2021-04-13 19:34:36 +03:00
<img align="left" width="44px" src="https://raw.githubusercontent.com/enso-org/icons/master/blue/with-bg/it/school/063-palette.svg">
2021-02-01 14:01:07 +03:00
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>A cutting-edge visualization engine.</b><br/>
Enso is equipped with a highly-tailored WebGL visualization engine capable
of displaying many millions of data points at 60 frames per second in a web
browser. Currently, Enso includes a set of core data visualizations out of
the box, and you can easily extend it with libraries such as D3.js,
Three.js, Babylon.js, deck.gl, VTK.js, Potree, and many more.
<br/><a href="https://enso.org">Learn more →<a/>
2021-02-01 14:01:07 +03:00
</ul></ul>
2021-04-13 19:34:36 +03:00
<img align="left" width="44px" src="https://raw.githubusercontent.com/enso-org/icons/master/blue/with-bg/it/shipping/004-cargo-ship.svg">
2021-02-01 14:01:07 +03:00
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>Runs everywhere.</b><br/>
Enso is available on macOS, Windows, and GNU/Linux, and the Enso IDE runs on
2021-04-13 19:13:47 +03:00
web-native technologies. In time, you'll be able to run it in the
web-browser, giving even your tablet and phone access to your data.
<br/><a href="https://enso.org">Learn more →<a/>
2021-02-01 14:01:07 +03:00
</ul></ul>
2021-01-26 20:22:10 +03:00
<br/>
2020-04-21 23:00:27 +03:00
2021-04-13 19:13:47 +03:00
# Getting Started
2020-07-21 15:59:40 +03:00
<img align="right" alt="An example Enso graph" src="https://user-images.githubusercontent.com/1623053/105841783-7c1ed400-5fd5-11eb-8493-7c6a629a84b7.png" width="380">
2021-02-01 14:01:07 +03:00
<img align="left" width="36px" src="https://github.com/google/material-design-icons/blob/master/src/action/get_app/materialiconsround/24px.svg">
<ul><ul>
<b>Download Enso</b><br/>
<ul>
2022-11-29 09:43:11 +03:00
<li><a href="https://github.com/enso-org/enso/releases">Enso Interactive Environment</a></li>
<li><a href="https://github.com/enso-org/enso/releases">Enso Compiler (CLI, optional)</a></li>
</ul>
2021-02-01 14:01:07 +03:00
</ul></ul>
<img align="left" width="36px" src="https://github.com/google/material-design-icons/blob/master/src/social/school/materialiconsround/24px.svg">
<ul><ul>
<b>Watch Tutorials</b><br/>
<ul>
2021-12-13 01:43:25 +03:00
<li><a href="https://github.com/enso-org/enso/blob/develop/app/gui/docs/product/shortcuts.md">Enso keyboard shortcuts</a></li>
<li><a href="https://youtu.be/_Twh45PI_vU&list=PLk8NuufOVK01GhaObYr1_gqeASlkj2um0">Enso 101</a></li>
2021-04-13 19:13:47 +03:00
<li><a href="https://youtu.be/hFxugfGbvGI?list=PLk8NuufOVK01GhaObYr1_gqeASlkj2um0">Analyze trams data</a></li>
<li><a href="https://youtu.be/gXnojGR6wOI?list=PLk8NuufOVK01GhaObYr1_gqeASlkj2um0">Analyze GitHub Stargazers data</a></li>
<li><a href="https://www.youtube.com/playlist?list=PLk8NuufOVK01GhaObYr1_gqeASlkj2um0">... other tutorials</a></li>
</ul>
2021-02-01 14:01:07 +03:00
</ul></ul>
<img align="left" width="36px" src="https://github.com/google/material-design-icons/blob/master/src/hardware/cast_for_education/materialiconsround/24px.svg">
<ul><ul>
<b>Watch Video Podcasts</b><br/>
<ul>
<li><a href="https://www.youtube.com/watch?v=U3pb7HiZIBg&t=2996s&ab_channel=Enso">Enso Textual Language Basics</a></li>
2021-04-13 19:13:47 +03:00
<li><a href="https://youtu.be/bcpOEX1x06I">Using Java libraries in Enso</a></li>
<li><a href="https://youtu.be/wFkh5LgAZTs">Custom data visualizations</a></li>
<li><a href="https://youtu.be/BibjcUjdkO4">Enso vision. What is in the future?</a></li>
<li><a href="https://www.youtube.com/c/Enso_org/videos?view=2&sort=dd&live_view=503&shelf_id=3">... other video podcasts</a></li>
</ul>
2021-02-01 14:01:07 +03:00
</ul></ul>
<img align="left" width="36px" src="https://github.com/google/material-design-icons/blob/master/src/communication/forum/materialiconsround/24px.svg">
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>Join Our Community</b><br/>
<ul>
<li><a href="https://discord.gg/enso">Discord chat. Get help, share your use cases, meet the team behind Enso and other Enso users!</a></li>
</ul>
2021-02-01 14:01:07 +03:00
</ul></ul>
<img align="left" width="36px" src="https://github.com/google/material-design-icons/blob/master/src/av/new_releases/materialiconsround/24px.svg">
<ul><ul>
2021-04-13 19:13:47 +03:00
<b>Keep Up With the Latest Updates</b><br/>
<ul>
<li><a href="https://medium.com/@enso_org">Enso Development Blog</a></li>
<li><a href="http://eepurl.com/bRru9j">Enso Mailing List</a></li>
</ul>
2021-02-01 14:01:07 +03:00
</ul></ul>
<br/><br/>
2020-04-21 23:00:27 +03:00
2021-04-13 19:13:47 +03:00
# Enso Source Code
2021-09-20 11:35:00 +03:00
If you want to start _using_ Enso, please see the download links in the
[getting started](#getting-started) section above. Alternatively, you can get
2023-04-11 16:55:06 +03:00
the IDE [here](https://github.com/enso-org/enso/releases). This section is
intended for people interested in contributing to the development of Enso.
2021-09-20 11:35:00 +03:00
2021-04-13 19:13:47 +03:00
Enso is a community-driven open source project which is, and will always be,
open and free to use. Join us, help us to build it, and spread the word!
<br/>
### Project Components
2020-07-21 15:59:40 +03:00
2021-01-26 20:22:10 +03:00
Enso consists of several sub projects:
2020-04-21 23:00:27 +03:00
2021-04-13 19:13:47 +03:00
- **Enso Engine:** The Enso Engine is the set of tools that implement the Enso
2021-04-15 13:34:17 +03:00
language and its associated services. These include the Enso interpreter, a
just-in-time compiler and runtime (both powered by
[GraalVM](https://www.graalvm.org)), and a language server that lets you
inspect Enso code as it runs. These components can be used on their own as
2021-02-01 14:01:07 +03:00
command line tools.
- **Enso IDE:** The
2024-05-10 19:13:59 +03:00
[Enso IDE](https://github.com/enso-org/enso/tree/develop/app/gui2) is a
desktop application that allows working with the visual form of Enso. It
consists of an Electron application, a high performance WebGL UI framework,
and the searcher which provides contextual search, hints, and documentation
for all of Enso's functionality.
2021-01-26 20:22:10 +03:00
<br/>
### License
2020-07-21 15:59:40 +03:00
2021-02-01 14:01:07 +03:00
The Enso Engine 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/develop/LICENSE) file. The Enso
IDE is licensed under the [AGPL 3.0](https://opensource.org/licenses/AGPL-3.0),
as specified in the
[LICENSE](https://github.com/enso-org/enso/blob/develop/app/gui2/LICENSE) file.
This license set was chosen to provide you with 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.
2021-01-26 20:22:10 +03:00
<br/>
### 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
2021-02-01 14:01:07 +03:00
our [chat](https://discord.gg/enso), 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.
2021-01-26 20:22:10 +03:00
<br/>
### Enso's Design
If you would like to gain a better understanding of the principles on which Enso
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
2021-04-07 22:16:05 +03:00
[the developer docs website](https://enso.org/docs/developer).
2021-01-26 20:22:10 +03:00
2021-02-01 14:01:07 +03:00
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.
2021-01-26 20:22:10 +03:00
This documentation will evolve as Enso does, both to help newcomers to the
project understand the reasoning behind the code, and also to act as a record of
2021-01-26 20:22:10 +03:00
the decisions that have been made through Enso's evolution.