Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

README files #132

Merged
merged 2 commits into from
Feb 29, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions examples/docker/ocr-solara/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# OCR app

A Solara app to extract text from images.
4 changes: 4 additions & 0 deletions examples/docker/personality-quiz-rag-solara/README.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
3 changes: 3 additions & 0 deletions examples/docker/shiny-express/README.md
Original file line number Diff line number Diff line change
@@ -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.
4 changes: 3 additions & 1 deletion examples/docker/shiny/README.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
4 changes: 3 additions & 1 deletion examples/docker/solara/README.md
Original file line number Diff line number Diff line change
@@ -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.
A Solara app 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
Expand Down
3 changes: 3 additions & 0 deletions examples/docker/streamlit/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# A basic app

A basic Streamlit app.
2 changes: 2 additions & 0 deletions examples/docker/video-rag/README.md
Original file line number Diff line number Diff line change
@@ -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/)
Expand Down
4 changes: 3 additions & 1 deletion examples/docker/voila/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
# Custom Voila app
# Scotch data visualisation

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.
2 changes: 1 addition & 1 deletion examples/panel/chat-with-github/README.md
Original file line number Diff line number Diff line change
@@ -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):

Expand Down
4 changes: 3 additions & 1 deletion examples/panel/chat-with-pdf/README.md
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 3 additions & 0 deletions examples/panel/data-viz/README.md
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 2 additions & 0 deletions examples/panel/rag-news/README.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
3 changes: 3 additions & 0 deletions examples/shiny-r/shiny-r-data-visualization/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Data visualization

An app for visualising the Penguins dataset.
4 changes: 3 additions & 1 deletion examples/shiny/basic-app/README.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
3 changes: 3 additions & 0 deletions examples/shiny/express-tip-calculator/README.md
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 3 additions & 0 deletions examples/solara/arxiv-chat/README.md
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 3 additions & 0 deletions examples/solara/gpt-4-tokenizer/README.md
Original file line number Diff line number Diff line change
@@ -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.
4 changes: 3 additions & 1 deletion examples/solara/keyword-extraction/README.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
3 changes: 3 additions & 0 deletions examples/solara/ocr/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# OCR app

A Solara app to extract text from images.
4 changes: 4 additions & 0 deletions examples/solara/personality-quiz-rag/README.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 2 additions & 0 deletions examples/solara/video-rag/README.md
Original file line number Diff line number Diff line change
@@ -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/)
Expand Down
3 changes: 3 additions & 0 deletions examples/streamlit/basic-app/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# A basic app

A basic Streamlit app.
3 changes: 3 additions & 0 deletions examples/streamlit/data-viz/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Data visualisation

An interactive app that explores a public Uber dataset for pickups and drop-offs in New York City.
3 changes: 3 additions & 0 deletions examples/voila/animated-viz/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Data visualisation

An interactive app that allows users to explore population by continent or countries.
4 changes: 3 additions & 1 deletion examples/voila/basic-app/README.md
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 3 additions & 0 deletions examples/voila/chat-with-csv/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Chat with a CSV

Chat with a CSV file using natural language.
3 changes: 3 additions & 0 deletions examples/voila/env-variable/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Environment variable

A simple app for demonstrating how to access environment variables in Ploomber Cloud.
3 changes: 3 additions & 0 deletions examples/voila/image-mask-generator/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Mask generator

This tool allows you to create mask images, required by inpainting models such as Stable Diffusion Inpainting.
3 changes: 3 additions & 0 deletions examples/voila/jupysql/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Analytical application

An application that uses the Penguins dataset to demonstrate model prediction values given an input.
3 changes: 3 additions & 0 deletions examples/voila/ml/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Machine Learning

An application that uses the Penguins dataset to demonstrate model prediction values given an input.
3 changes: 3 additions & 0 deletions examples/voila/mosaic/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Mosaic visualisation app

This application uses Mosaic to display plots that are interactive and linked together through cross-filtering.
3 changes: 3 additions & 0 deletions examples/voila/object-removal/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Object Removal app

This app allows you to remove objects from images.