Hello World – Keboola Python/JS Data App

The simple example app for the Keboola platform. It displays a page with "Hello from Keboola!" in the browser.

Project Structure

helloworld/
├── keboola-config/
│   ├── nginx/
│   │   └── sites/
│   │       └── default.conf    # Nginx reverse proxy configuration
│   ├── supervisord/
│   │   └── services/
│   │       └── app.conf        # Supervisord configuration for running the app
│   └── setup.sh                # Setup script (dependency installation)
├── pyproject.toml              # Project definition and dependencies
└── app.py                      # Flask application

How It Works

The app is built on Flask and runs as a simple HTTP server.

• Flask listens on port 5000 (internal)
• Nginx acts as a reverse proxy and exposes the app on port 8888 (public)
• Supervisord ensures the app starts automatically and restarts on failure
• uv is used as the dependency and environment manager

Requirements

• Python 3.11+
• uv

Running Locally

1. Install dependencies:

   uv sync

2. Start the application:

   uv run python app.py

3. Open your browser at http://localhost:5000

Dependencies

Package	Version
flask	>=3.0.0