2020-11-12 20:58:09 +00:00
# Squiggle
2022-04-12 05:41:36 +00:00
2022-04-11 23:39:07 +00:00
[](https://github.com/quantified-uncertainty/squiggle/actions/workflows/ci.yml)
2022-04-28 23:06:39 +00:00
[](https://www.npmjs.com/package/@quri/squiggle-lang)
[](https://www.npmjs.com/package/@quri/squiggle-components)
2022-04-11 23:37:58 +00:00
[](https://github.com/quantified-uncertainty/squiggle/blob/develop/LICENSE)
2022-04-12 00:48:07 +00:00
[](https://codecov.io/gh/quantified-uncertainty/squiggle)
2020-02-05 21:09:27 +00:00
2022-04-28 23:06:39 +00:00
_An estimation language_.
## Get started
- [Gallery ](https://www.squiggle-language.com/docs/Discussions/Gallery )
- [Squiggle playground ](https://squiggle-language.com/playground )
- [Language basics ](https://www.squiggle-language.com/docs/Features/Language )
- [Squiggle functions source of truth ](https://www.squiggle-language.com/docs/Features/Functions )
- [Known bugs ](https://www.squiggle-language.com/docs/Discussions/Bugs )
- [Original lesswrong sequence ](https://www.lesswrong.com/s/rDe8QE5NvXcZYzgZ3 )
- [Author your squiggle models as Observable notebooks ](https://observablehq.com/@hazelfire/squiggle )
2020-03-09 13:29:18 +00:00
2022-03-25 16:45:40 +00:00
## Our deployments
2022-04-11 01:29:27 +00:00
- **website/docs prod**: https://squiggle-language.com [](https://app.netlify.com/sites/squiggle-documentation/deploys)
2022-04-11 23:37:58 +00:00
- **website/docs staging**: https://develop--squiggle-documentation.netlify.app/
2022-04-12 06:45:14 +00:00
- **components storybook prod**: https://squiggle-components.netlify.app/ [](https://app.netlify.com/sites/squiggle-components/deploys)
- **components storybook staging**: https://develop--squiggle-components.netlify.app/
- **legacy (2020) playground**: https://playground.squiggle-language.com
2022-03-25 16:45:40 +00:00
2022-03-28 20:26:25 +00:00
## Packages
2022-04-12 05:41:36 +00:00
This monorepo has several packages that can be used for various purposes. All
2022-02-28 23:59:48 +00:00
the packages can be found in `packages` .
2020-03-09 13:29:18 +00:00
2022-03-24 18:42:27 +00:00
- `@quri/squiggle-lang` in `packages/squiggle-lang` contains the core language, particularly
2022-04-12 05:41:36 +00:00
an interface to parse squiggle expressions and return descriptions of distributions
or results.
2022-03-24 18:42:27 +00:00
- `@quri/squiggle-components` in `packages/components` contains React components that
2022-04-12 05:41:36 +00:00
can be passed squiggle strings as props, and return a presentation of the result
of the calculation.
2022-04-28 23:06:39 +00:00
- `packages/website` is the main descriptive website for squiggle,
2022-04-12 05:41:36 +00:00
it is hosted at `squiggle-language.com` .
2022-02-28 23:59:48 +00:00
2022-03-25 00:11:31 +00:00
The playground depends on the components library which then depends on the language. This means that if you wish to work on the components library, you will need to build (no need to bundle) the language, and as of this writing playground doesn't really work.
2022-02-28 23:59:48 +00:00
2022-03-23 22:34:50 +00:00
# Develop
2022-02-28 23:59:48 +00:00
2022-04-18 06:02:47 +00:00
For any project in the repo, begin by running `yarn` in the top level
2022-04-20 17:51:27 +00:00
2022-04-12 05:41:36 +00:00
```sh
2022-03-23 22:34:50 +00:00
yarn
2022-03-23 14:39:32 +00:00
```
2022-03-23 22:34:50 +00:00
2022-04-12 05:41:36 +00:00
See `packages/*/README.md` to work with whatever project you're interested in.
2022-03-24 18:42:27 +00:00
# Contributing
2022-04-12 05:41:36 +00:00
See `CONTRIBUTING.md` .
