Skip to content

docs: add guide for building Streamlit data apps with Keboola Storage#866

Draft
yustme wants to merge 2 commits intomainfrom
devin/1769189641-data-app-storage-guide
Draft

docs: add guide for building Streamlit data apps with Keboola Storage#866
yustme wants to merge 2 commits intomainfrom
devin/1769189641-data-app-storage-guide

Conversation

@yustme
Copy link
Contributor

@yustme yustme commented Jan 23, 2026

Jira issue(s): PROOF-XXX (proofreading needed)

Changes:

  • Added new documentation guide under AI Features section explaining how to build Streamlit data apps that communicate with Keboola Storage
  • Updated navigation.yml to include the new page

The guide covers:

  • Reading tables from Keboola Storage using the Python client (kbcstorage)
  • Displaying and editing data with Streamlit's st.data_editor
  • Writing changes back to Storage (full and incremental loads)
  • Complete working example application
  • Best practices for token security and error handling

Updates since last revision

Addressed PR review feedback:

  • Added hyperlinks to Data Apps and Storage documentation in the Overview section
  • Fixed "Step 2: Configure Secrets" section to clarify that kbc_url and kbc_token are automatically provisioned by default (users don't need to configure them manually)

Requested by: Vojta Tuma (@yustme)

Link to Devin run: https://app.devin.ai/sessions/93008265a97d40989a3fbd52a603be6e

Human review checklist:

  • Review potential overlap with AI Kit repo (per @jordanrburger's comment)
  • Verify kbc_url and kbc_token are the correct auto-provisioned secret names
  • In read_table function example, there's an unused csv.reader - consider if this should be removed for clarity
  • Check that the complete example handles edge cases properly (e.g., lastImportDate being None on line 362)
  • Confirm navigation placement under "AI Features" is appropriate

Release Notes

Justification, description

Documentation addition to help users build Streamlit data apps that interact with Keboola Storage for reading, editing, and saving table data.

Plans for Customer Communication

N/A

Impact Analysis

N/A - documentation only

Deployment Plan

N/A

Rollback Plan

N/A

Post-Release Support Plan

N/A

This documentation covers:
- Reading tables from Keboola Storage using the Python client
- Displaying and editing data with Streamlit's data_editor
- Writing changes back to Storage (full and incremental loads)
- Complete working example application
- Best practices for token security and error handling

Co-Authored-By: Vojta Tuma <vojta.tuma@keboola.com>
@devin-ai-integration
Copy link
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@jordanrburger
Copy link
Contributor

@yustme - There seems to be overlap here with the AI Kit repo. I would be nervous about that. Pls review that first and consider whether or not it makes sense to borrow the info from there.


## Overview

Data apps in Keboola provide a powerful way to create interactive web applications that work directly with your data stored in Keboola Storage. A typical use case is building a data editor that allows business users to view and modify table contents without needing direct access to the Keboola platform.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You need hyperlinks to other parts of the docs. e.g. Data Apps should link to the actual data apps page.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed - added hyperlinks to Data Apps and Storage documentation pages in the Overview section.


### Step 2: Configure Secrets

In the Secrets section of your data app configuration, add the following secrets:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't true. You don't need to add either of these secrets. They already exist by default.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed - updated the section to clarify that kbc_url and kbc_token are automatically provisioned by default and users don't need to configure them manually.

- Add hyperlinks to Data Apps and Storage documentation pages
- Fix secrets configuration section to clarify credentials are auto-provisioned

Co-Authored-By: Vojta Tuma <vojta.tuma@keboola.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants