InvokeAI icon indicating copy to clipboard operation
InvokeAI copied to clipboard

[Docs] ELI5 Tutorial For Invocations

Open blessedcoolant opened this issue 2 years ago • 4 comments

Work in progress. Just putting it out there to see if its worth pursuing writing indepth detailed guides.

Can be previewed here: https://github.com/blessedcoolant/InvokeAI/blob/docs-invocations/docs/contributing/INVOCATIONS.md

blessedcoolant avatar Jun 09 '23 10:06 blessedcoolant

This type of documentation is going to be critical. Thanks for putting it together. I've given it a once over, but will get perspective of @brandonrising next week on how clear it is to fresh eyes, and where we can expand.

hipsterusername avatar Jun 10 '23 03:06 hipsterusername

This looks great! Definitely valuable and worth investing in. One question for the advanced section probably, are invocations allowed to use InvokeAIAppConfig? Any best practices there?

FWIW - I'm planning on writing a blog post or two about converting some arbitrary paper's sample code into an invocation. Probably SAM (or a variant) and Deep Floyd. Started to do that already but figured I should wait until the new model management stuff is in.

aluhrs13 avatar Jun 13 '23 02:06 aluhrs13

self.is_intermediate is used but never defined

aluhrs13 avatar Jun 13 '23 05:06 aluhrs13

self.is_intermediate is used but never defined

Yes. I'll update this when I'm refining the PR later. I'm just waiting on all the services to settle in. self.is_intermediate is used to determine an intermediate image. Not applicable in this case.

are invocations allowed to use InvokeAIAppConfig

Basically we'll want the dev to access the config via the service rather than trying to instantiate their own class of InvokeAIAppConfig .. so it should be context.services.configuration.xxxx to access any of the data provided by the app config. But services are only applicable inside the invoke context. If you want to use them outside of it, I think we load the global instance. I'll let @lstein chime in on that because he has a better knowledge of the workings of InvokeAIAppConfig

blessedcoolant avatar Jun 13 '23 05:06 blessedcoolant

@blessedcoolant - Thoughts on the status/timing of this doc? Have it on the list of things to have ready for 3.0 launch

hipsterusername avatar Jul 06 '23 03:07 hipsterusername

The docs are good for the backend stuff. They front end stuff is still WIP. But that's a big write up. So don't really have an ETA on that.

blessedcoolant avatar Jul 06 '23 04:07 blessedcoolant

The docs are good for the backend stuff. They front end stuff is still WIP. But that's a big write up. So don't really have an ETA on that.

Ok - should we merge this in then? Or can merge over to the doc-updates branch if you want

hipsterusername avatar Jul 06 '23 12:07 hipsterusername

The docs are good for the backend stuff. They front end stuff is still WIP. But that's a big write up. So don't really have an ETA on that.

Ok - should we merge this in then? Or can merge over to the doc-updates branch if you want

Yeah. Soak it into that. When I do more documentation for the front end stuff, I can build on that. But that'll have to wait for a bit.

blessedcoolant avatar Jul 06 '23 12:07 blessedcoolant