Programming language for distributed systems & p2p
Go to file
renovate[bot] 77864202d1
chore(deps): update dependency sbt/sbt to v1.9.4 (#860)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2023-09-01 15:42:23 +03:00
.devcontainer feat(devcontainer): Add js-client to devcontainer (#736) 2023-06-09 08:44:54 +00:00
.github chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
.vscode Add support for the new features of JS SDK API (#251) 2021-09-08 13:16:59 +03:00
api chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
aqua-run/src/main/scala/aqua/run fix(compiler): Refactor values [fixes LNG-57] (#821) 2023-08-15 13:33:34 +03:00
aqua-src feat: parseq implementation (fixes LNG-223) (#840) 2023-08-21 14:26:30 +04:00
backend feat(js-client)!: Move to new js-client interface (#855) 2023-08-25 11:39:10 +03:00
cli chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
compiler/src feat: parseq implementation (fixes LNG-223) (#840) 2023-08-21 14:26:30 +04:00
integration-tests chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
io feat(compiler): Find and display link cycles (#787) 2023-07-04 10:07:22 +00:00
js refactor(js): NPM modules resolution (#722) 2023-05-31 12:00:13 +02:00
language-server chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
linker/src fix(compiler): Fix search for one element cycles (#797) 2023-07-14 15:06:21 +03:00
model feat(compiler): Restrict abilities usage [fixes LNG-208] (#854) 2023-08-24 16:09:39 +03:00
parser/src feat(compiler): Restrict abilities usage [fixes LNG-208] (#854) 2023-08-24 16:09:39 +03:00
project chore(deps): update dependency sbt/sbt to v1.9.4 (#860) 2023-09-01 15:42:23 +03:00
semantics/src feat(compiler): Restrict abilities usage [fixes LNG-208] (#854) 2023-08-24 16:09:39 +03:00
types/src feat(compiler): Restrict abilities usage [fixes LNG-208] (#854) 2023-08-24 16:09:39 +03:00
utils fix(compiler): Generate stream restriction for scoped exprs [fixes LNG-222] (#841) 2023-08-17 10:30:02 +04:00
.gitignore chore: Refactor CI after moving tests from aqua-playground [fixes FLU-352] (#763) 2023-06-22 14:59:56 +03:00
.jvmopts Upper cased constants (#260) 2021-09-07 11:09:48 +03:00
.scalafmt.conf VarModel -> VarRaw in collect functions (#405) 2022-01-20 07:08:26 +03:00
build.sbt chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
CHANGELOG.md chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
ci.cjs chore: Refactor CI after moving tests from aqua-playground [fixes FLU-352] (#763) 2023-06-22 14:59:56 +03:00
CONTRIBUTING.md feat(docs): README update (#667) 2023-02-20 11:42:55 +03:00
INSTALL.md feat(docs): README update (#667) 2023-02-20 11:42:55 +03:00
LICENSE feat(docs): README update (#667) 2023-02-20 11:42:55 +03:00
pnpm-lock.yaml chore(main): release aqua 0.12.0 (#853) 2023-08-25 11:55:20 +03:00
pnpm-workspace.yaml feat: wrap aqua api (#807) 2023-08-09 17:32:27 +03:00
README.md chore: Refactor CI after moving tests from aqua-playground [fixes FLU-352] (#763) 2023-06-22 14:59:56 +03:00

Aqua

release npm

Aqua is an open-source language for distributed workflow coordination in p2p networks. Aqua programs are executed on many peers, sequentially or in parallel, forming a single-use coordination network. Applications are turned into hostless workflows over distributed function calls, which enables various levels of decentralization: from handling by a limited set of servers to complete peer-to-peer architecture by connecting user devices directly. Aqua is the core of the Fluence protocol and a framework for internet or private cloud applications.

Installation and Usage

The easiest way to use Aqua is to download the latest build from npm: @fluencelabs/aqua.

npm i -g @fluencelabs/aqua
aqua --input src/aqua --output src/generated

Input directory should contain files with .aqua scripts.

Other ways of installing Aqua can be found in INSTALL.md.

Documentation

Comprehensive documentation and usage examples as well as a number of videos can be found in Aqua Book. Aqua Playground demonstrates how to start writing Aqua and integrate it into a TypeScript application. Numerous videos are available at our YouTube channel.

Repository Structure

  • api - Aqua API for JS
  • aqua-run - Aqua API to run functions
  • backend - compilation backend interface
  • cli - CLI interface
  • compiler - compiler as a pure function made from linker, semantics and backend
  • model - middle-end, internal representation of the code, optimizations and transformations
    • transform - optimizations and transformations, converting model to the result, ready to be rendered
    • test-kit - tests and test helpers for the model and transformations
  • linker - checks dependencies between modules, builds and combines an abstract dependencies tree
  • parser - parser, takes source text and produces a source AST
  • semantics - rules to convert source AST into the model
  • types - data types, arrows, stream types definitions and variance

Support

Please, file an issue if you find a bug. You can also contact us at Discord or Telegram. We will do our best to resolve the issue ASAP.

Contributing

Any interested person is welcome to contribute to the project. Please, make sure you read and follow some basic rules.

License

All software code is copyright (c) Fluence Labs, Inc. under the Apache-2.0 license.