Skip to content

feat: curriculum structure#1

Merged
deanq merged 1 commit intomainfrom
deanq/ae-1471-alpha-flash-examples
Nov 15, 2025
Merged

feat: curriculum structure#1
deanq merged 1 commit intomainfrom
deanq/ae-1471-alpha-flash-examples

Conversation

@deanq
Copy link
Member

@deanq deanq commented Nov 15, 2025

This establishes initial curriculum structure to cover for our examples repo. We can change any of these as we move forward, but this is a start.

@linear
Copy link

linear bot commented Nov 15, 2025

@deanq deanq requested review from jhcipar and muhsinking November 15, 2025 06:27

## What is Flash?

Flash is a CLI tool and framework from the `tetra_rp` package that enables you to build FastAPI applications with workers that run on Runpod's serverless infrastructure. Write your code locally, and Flash handles deployment, scaling, and resource management.
Copy link
Contributor

Choose a reason for hiding this comment

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

FastAPI is a great first class citizen in flash, but I don't want to limit it to saying it's just a way to create FastAPI applications. To me the bigger sell is about Flash being holistic glue that makes it easy and enjoyable to build ML-powered applications on Runpod infra.

```

## Examples by Category

Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure if this belongs in the examples repo, but I'm tempted to say somewhere in the topline readme it could be cool to have a couple loc showing an example of how easy it is to run and manage resources on Runpod - eg

@remote
def serve_inference(data):
  return ...

@jhcipar
Copy link
Contributor

jhcipar commented Nov 15, 2025

One other thought I'm having is around use cases - to me I can imagine two ways that people will use Flash

  1. baking Runpod Flash/function code into other Python native applications (eg just pop a LiveServerless function into your existing Flask app and it'll run on Runpod infra
  2. creating a self-contained application that you can deploy entirely on Runpod and then interact with them via HTTP

Is it worth making any examples for these? and/or how does that fit into the current setup w/ a fastapi mothership endpoint? maybe outside the scope of this PR though

@deanq
Copy link
Member Author

deanq commented Nov 15, 2025

Great thinking! The way we discover and classify independent handlers with the FastAPI approach is just a protocol recognition pattern. We can extend this to other known patterns. We can even allow, in the future, a BYO-pattern for handler discovery.

@deanq deanq merged commit 9fc40d4 into main Nov 15, 2025
@deanq deanq deleted the deanq/ae-1471-alpha-flash-examples branch November 15, 2025 21:29
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