So… this is pretty much the opposite of “what I got”, but: I’m lucky enough to start from zero with prefect and I know it is easy to forget what we found to be confusing, so in my “prefect hello world” repo I made sure the readme included my thoughts as I created an account and went along with the getting started resources. Just in case anyone finds it useful. It is an honest attempt to record my first impression: https://github.com/radbrt/prefect_pipeline. I’m happy to add to the documentation once I get a little experience.

Thanks for the feedback! We appreciate it a lot. We're working on improving the beginner experience and there's definitely a mix of old/new patterns lurking still. A few points • The

prefect auth login

CLI is way easier than editing the config manually. What led you to that route? • This discussion on flow deployment patterns may be helpful for your CI/CD questions https://github.com/PrefectHQ/prefect/discussions/4042 -- we are still learning what the best pattern is and once we have a stronger opinion it will make it into the docs • I would not register flows in the flow script itself. Previously, that was the easiest way to do it, but now the CLI

prefect register

/

prefect run

is more fleshed out and easier to use • Prefect Cloud cannot run jobs on your infrastructure. This is an important part of the hybrid model which creates the necessity for an agent. They're super lightweight so they're generally not hard to leave running. You can also run flows that report to the UI without an agent but then you'll need to manage scheduling yourself. We're exploring ways to reduce this burden in the future.

Wow, thanks for the follow up - on a saturday no less! Most of what I did was because it was the first thing I found on the site, but reading through the getting started section again it is clear that I must have veered into the documentation and jumped around randomly. I see your point about the hybrid model, I guess I just have serverless on my mind these days. The ci/cd page looks very interesting. And I got things running on coiled now, so I am ready to start real development next.

No problem 🙂 We're pretty interested in finding a way to make serverless first-class, the agent is an awkward step for that right now.

Ah, found the tutorial that told me to create a config file and auth_token manually. Seems it is only available once logged in: https://cloud.prefect.io/tutorial/Universal-Deploy#creating-a-project