> For the complete documentation index, see [llms.txt](https://docs.riff.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.riff.ai/archive/getting-started-legacy/quickstart.md).
# Quickstart App
You’ll get a one‑page app that ingests comments, clusters themes with example quotes, scores sentiment, and suggests your top 3 actions.
**Perfect for:** NPS comments, reviews, support snippets, survey answers.
### Features
:message-lines:
Feedback Analysis
Upload a csv file containing review feedback.
:brain-circuit:
GPT-4 Integration
Generate intelligent, context-aware insights using OpenAI’s GPT-4
{% embed url="" %}
### Create your feedback insights app
{% stepper %}
{% step %}
**Step 1 - Create an account**
Go to [riff.a](https://riff.hot/home)i and sign up.
{% endstep %}
{% step %}
**Step 2 - Describe your app**
Paste this into the prompt box:
> “A simple tool that analyses customer comments: deduplicate, detect sentiment, group into themes with example quotes, and suggest the top three actions. Show a clean dashboard and let me export results.”
Submit the prompt.
{% endstep %}
{% step %}
**Step 3 - Choose your data source**
When asked where the data lives, choose **CSV upload**.
{% endstep %}
{% step %}
**Step 4 - Confirm the plan → Build**
Riff will generate a **Riff Card** — the build plan. Review it. Adjust if needed. Click **Confirm plan → Build project**.
{% endstep %}
{% step %}
**Step 5 - Complete the tasks**
Your workspace is live. The agent[ creates a task list](/archive/features-legacy-databutton-web-app-builder/workspace-features/tasks.md) and runs until it needs input.
Typical first tasks:
* **Functional landing page**
* **API to process CSV**
* **Integrate AI**
{% hint style="info" %}
You can view these by **clicking on the**[ **Tasks tab** ](/archive/features-legacy-databutton-web-app-builder/workspace-features/tasks.md)a the top of the workspace.
{% endhint %}
The agent will complete the first few tasks until it needs input from you.
{% tabs %}
{% tab title="Task 1 - Functional landing page" %}
On the Preview tab, you will see a CSV upload interface.
{% hint style="info" %}
*Note: at this stage the uploader will not work, the agent has created tasks to complete this which we will see in later stages.*
{% endhint %}
{% endtab %}
{% tab title="Task 2 - API to process CSV" %}
{% hint style="info" %}
Note: an API is..... you can view this by clicking on +More >
{% endhint %}
{% endtab %}
{% tab title="Task 3 - Integrate AI " %}
The agent will ask you for your Open AI API key and then create a secure API to process the insights.
{% hint style="info" %}
You may be prompted for an **OpenAI API key** or an alternative model. Enter the key when asked, or tell the agent which model to use.
{% endhint %}
{% endtab %}
{% endtabs %}
{% endstep %}
{% step %}
**Step 6 - Use your app**
Upload your CSV and view the dashboard with AI results: themes, sentiment, and next actions.
{% hint style="info" %}
**Tip:** Ask the agent to generate a sample file so you can test quickly:
{% endhint %}
> “Create a downloadable CSV that shows the expected format. Include a batch of sample rows.”
When it looks right: **Deploy → choose a short URL → Deploy app.** Share the link. Teammates can paste their own comments and get instant insights.
{% endstep %}
{% step %}
**Well done!**
You have successfully created your first application! Here's some next steps you can take:
* Continue building your app, ask the agent to give you some more ideas.
* [Explore use cases](broken://pages/MIAz0lHW1Akuydsahorm)
* [Learn about integrations](/integrations/about-integrations-v2.md)
* [Dive into the Riff features](broken://pages/HA948x2MtJje5JZkQzVG)
{% endstep %}
{% endstepper %}
How do I get an OpenAI API key?
1. **Go to** `platform.openai.com` and **sign in** (or **sign up**).
2. **Open** your profile (top-right) → **API keys**\
– or jump to `platform.openai.com/api-keys`.
3. **Create new secret key.** Name it (optional). **Copy it now** — you won’t see it again.
4. **Add billing:** **Settings → Billing.** Add a card. Set usage limits.
5. **Store it in Riff:** when the agent asks, paste the key — or say “Store `OPENAI_API_KEY`,” and we’ll save it via our secrets tool.
{% hint style="info" %}
Treat it like a password. Don’t paste in code or logs. Rotate if leaked.
{% endhint %}
Can I use another AI model?
Yes. Tell the agent during planning or while it’s building. If it’s a new or uncommon model, ask the agent to research setup details with its research tool.
What if my app does not work?
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.riff.ai/archive/getting-started-legacy/quickstart.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.