Merge branch 'main' into reorg-delete-examples

doc/_toc.yml

@@ -17,10 +17,6 @@ parts:
       - file: user-guide/custom-domains
       - file: user-guide/managing-apps
 
-  - caption: Sharing notebooks
-    chapters:
-      - file: nb-share/notebook-sharing
-
   - caption: Apps
     chapters:
       - file: apps/flask
@@ -44,9 +40,14 @@ parts:
     chapters:
       - file: examples/voila
 
+  - caption: Sharing notebooks
+    chapters:
+      - file: nb-share/notebook-sharing
+
   - caption: Pricing
     chapters:
       - file: pricing/overview
+      - file: pricing/compute
 
   - caption: FAQ
     chapters:

doc/pricing/compute.md

@@ -0,0 +1,28 @@
+# Compute pricing
+
+```{important}
+Access to large compute resources is reserved for certain PRO accounts, if you want
+us to enable it for your account, email us: [[email protected]](mailto:[email protected])
+```
+
+If your application requires more than 2vCPUs or 4GB of RAM, you can upgrade your hardware. On-demand resources are billed per-second, you can [stop your application](stop-application) whenever you want. Stopped applications are not billed.
+
+## On-demand prices
+
+|      | hour    | day     |
+|------|---------|---------|
+| vCPU | $0.0446 | $1.0704 |
+| GB   | $0.0049 | $0.1176 |
+
+*Prices in US dollars. Billed per second.*
+
+## Pricing examples
+
+- 4vCPU/8GB application running:
+    - One day (24 hours): $5.22
+    - One month (30 days): $156.67
+
+
+- 8vCPU/16GB application running:
+    - One day (24 hours): $10.44
+    - One month (30 days): $313.34

doc/pricing/overview.md

@@ -23,8 +23,8 @@
 
 - 10 concurrent apps max
 - 3 apps running 24/7 max (the rest are stopped, but can be restarted)
-- 2 vCPU per app (can upgrade hardware with on-demand resources)
-- 4 GiB RAM per app (can upgrade hardware with on-demand resources)
+- 2 vCPU per app (can upgrade hardware with [on-demand resources](compute.md))
+- 4 GiB RAM per app (can upgrade hardware with [on-demand resources](compute.md))
 - Unlimited deployment rate
 - Custom app name (e.g., `my-cool-app.ploomberapp.io`)
 - Custom domains (i.e., serve your app from `my-cool-app.com`)
@@ -36,10 +36,3 @@
 ### Ploomber Cloud Enterprise
 
 Customized plan to suit your needs. Send us an email to [[email protected]](mailto:[email protected]).
-
-## On-demand resources
-
-You can upgrade the app's resources (CPUs, RAM, GPUs). You'll be billed per-second,
-and you can downgrade the hardware at any time.
-
-We're beta testing on-demand resources. If you want to use it, send us an email to [[email protected]](mailto:[email protected]).

doc/user-guide/managing-apps.md

@@ -14,4 +14,12 @@ You may add as many labels as you want. Once you've added some labels, they will
 
 ![](../static/manage-apps/see-labels-status.png)
 
-![](../static/manage-apps/see-labels-main.png)
+![](../static/manage-apps/see-labels-main.png)
+
+
+(stop-application)=
+## Stop application
+
+If you want to stop your application, you can do so by opening the detailed view, clicking in the three dots (`...`) and then `Stop Job`:
+
+![](../static/manage-apps/stop-app.png)

examples/docker/ocr-solara/README.md

@@ -0,0 +1,3 @@
+# OCR app
+
+A Solara app to extract text from images.

examples/docker/shiny-express/README.md

@@ -0,0 +1,3 @@
+# Restaurant tipping dashboard
+
+A restaurant tipping dashboard designed to offer valuable insights into tipping behaviors like average tip, tips percentage over the week, etc. 

examples/docker/streamlit/README.md

@@ -0,0 +1,3 @@
+# A basic app
+
+A basic Streamlit app.

examples/panel/chat-with-github/README.md

@@ -1,6 +1,6 @@
 # Chat with Github
 
-This Panel app enables users to chat with their GitHub repositories using the llama_index [GithubRepositoryReader](https://docs.llamaindex.ai/en/stable/examples/data_connectors/GithubRepositoryReaderDemo.html).
+A Panel app that enables users to chat with their GitHub repositories using the llama_index [GithubRepositoryReader](https://docs.llamaindex.ai/en/stable/examples/data_connectors/GithubRepositoryReaderDemo.html).
 
 To run the app you need to set a couple of [environment variables](https://docs.cloud.ploomber.io/en/latest/user-guide/env-vars.html):
 

examples/panel/chat-with-pdf/README.md

@@ -1,6 +1,8 @@
 # Chat with a PDF
 
-This Panel app was [originally developed](https://github.com/holoviz-topics/panel-chat-examples/blob/main/docs/examples/langchain/langchain_pdf_assistant.py) by [Andrew Huang](https://github.com/ahuang11),
+A Panel app that allows users to chat with a PDF document.
+
+This app was [originally developed](https://github.com/holoviz-topics/panel-chat-examples/blob/main/docs/examples/langchain/langchain_pdf_assistant.py) by [Andrew Huang](https://github.com/ahuang11),
 and [Marc Skov Madsen](https://github.com/MarcSkovMadsen).
 
 [Click here](https://docs.cloud.ploomber.io/en/latest/apps/panel.html) to see deployment instructions.

examples/panel/data-viz/README.md

@@ -0,0 +1,3 @@
+# Penguin Crossfilter
+
+A Panel app that uses the box-select and lasso-select tools to select a subset of penguins and reveal more information about the selected subgroup through the power of cross-filtering.

examples/panel/rag-news/README.md

@@ -1,5 +1,7 @@
 # News summarizer
 
+A RAG application for summarizing the latest news.
+
 To download today's news and compute the embeddings you first need to set the OpenAI key:
 
 ```bash

examples/shiny-r/shiny-r-data-visualization/README.md

@@ -0,0 +1,3 @@
+# Data visualization
+
+An app for visualising the Penguins dataset.

examples/shiny/basic-app/README.md

@@ -1,6 +1,8 @@
 # Model monitoring application
 
-This app is built on Shiny and allows you to visualize model training accuracy scores in realtime in 2 steps:
+A Shiny app to visualize model training accuracy scores in realtime.
+
+## Steps
 
 * Train multiple models with different parameters locally, and store the accuracy scores to a remote database at the end of every epoch.
 * The visualisation application dynamically detects changes in the remote database and generates a plot as the training progresses.

examples/shiny/express-tip-calculator/README.md

@@ -0,0 +1,3 @@
+# Restaurant tipping dashboard
+
+A restaurant tipping dashboard designed to offer valuable insights into tipping behaviors like average tip, tips percentage over the week, etc.

examples/solara/arxiv-chat/README.md

@@ -0,0 +1,3 @@
+# Arxiv Chat
+
+A chat assistant that can help find academic papers using Arxiv and also allows users to chat with an uploaded article.

examples/solara/gpt-4-tokenizer/README.md

@@ -0,0 +1,3 @@
+# GPT4 Tokenizer
+
+A Solara app that shows how to use a language model tokenizer to encode and decode and how to search for a token.

examples/solara/keyword-extraction/README.md

@@ -1,6 +1,8 @@
 # Keyword Extraction Solara App
 
-This Solara app is designed for performing keyword extraction from text documents. Currently, it supports the packages `PyTextRank` and `Yake` for extracting the most relevant keywords from the input text. 
+This Solara app is designed for performing keyword extraction from text documents. 
+
+Currently, it supports the packages `PyTextRank` and `Yake` for extracting the most relevant keywords from the input text. 
 The extracted keywords can be useful for content analysis, search engine optimization (SEO), and other natural language processing tasks.
 
 ## Getting Started

examples/solara/ocr/README.md

@@ -0,0 +1,3 @@
+# OCR app
+
+A Solara app to extract text from images.

examples/solara/personality-quiz-rag/README.md

@@ -1,3 +1,7 @@
+# Personality Quiz
+
+A RAG application to deduce user's Myers-Briggs personality type from answers to quiz questions.
+
 ## How to run this application locally
 
 ### 1. Install dependencies

examples/solara/video-rag/README.md

@@ -1,5 +1,7 @@
 ## RAG from video
 
+A RAG application that takes video content as input and answers questions about it.
+
 This is a full stack project that uses a video as input, populates an ElasticSearch instance with vectors through an indexing pipeline, and initializes a retriver pipeline with a Solara app.
 
 A complete walk through of this application can be found [here](https://ploomber.io/blog/rag-video-app/)

examples/streamlit/basic-app/README.md

@@ -0,0 +1,3 @@
+# A basic app
+
+A basic Streamlit app.

examples/streamlit/data-viz/README.md

@@ -0,0 +1,3 @@
+# Data visualisation
+
+An interactive app that explores a public Uber dataset for pickups and drop-offs in New York City. 

examples/voila/animated-viz/README.md

@@ -0,0 +1,3 @@
+# Data visualisation
+
+An interactive app that allows users to explore population by continent or countries.

examples/voila/basic-app/README.md

@@ -1,3 +1,5 @@
-# Custom Voila app
+# Scotch data visualisation app
+
+A dashboard for visualising different properties of the type of scotch selected by the user.
 
 `app.ipynb` was taken from the [`voila-gridstack`](https://github.com/voila-dashboards/voila-gridstack/blob/main/examples/scotch_dashboard.ipynb) repository.

examples/voila/chat-with-csv/README.md

@@ -0,0 +1,3 @@
+# Chat with a CSV
+
+Chat with a CSV file using natural language.

examples/voila/env-variable/README.md

@@ -0,0 +1,3 @@
+# Environment variable
+
+A simple app for demonstrating how to access environment variables in Ploomber Cloud.

examples/voila/image-mask-generator/README.md

@@ -0,0 +1,3 @@
+# Mask generator
+
+This tool allows you to create mask images, required by inpainting models such as Stable Diffusion Inpainting.

examples/voila/jupysql/README.md

@@ -0,0 +1,3 @@
+# Analytical application
+
+An application that uses the Penguins dataset to demonstrate model prediction values given an input.

examples/voila/ml/README.md

@@ -0,0 +1,3 @@
+# Machine Learning
+
+An application that uses the Penguins dataset to demonstrate model prediction values given an input.

examples/voila/mosaic/README.md

@@ -0,0 +1,3 @@
+# Mosaic visualisation app
+
+This application uses Mosaic to display plots that are interactive and linked together through cross-filtering.

examples/voila/object-removal/README.md

@@ -0,0 +1,3 @@
+# Object Removal app
+
+This app allows you to remove objects from images.