๐Ÿ‘‹ Welcome to StableStudio, the open-source version of DreamStudio!

**๐Ÿ—บ Contents โ€“ [๐Ÿš€ Quick Start](#quick-start) ยท [โ„น๏ธ About](#about) ยท [๐Ÿ™‹ FAQ](#faq) ยท [๐Ÿง‘โ€๐Ÿ’ป Contributing](#contributing)** **๐Ÿ“š Documentation โ€“ [๐ŸŽจ UI](./packages/stablestudio-ui/README.md) ยท [๐Ÿ”Œ Plugins](./packages/stablestudio-plugin/README.md) ยท โšก๏ธ platform.stability.ai** **๐Ÿ”— Links โ€“ ๐ŸŽฎ Discord ยท ๐ŸŒˆ DreamStudio ยท ๐Ÿ›Ÿ Bugs & Support ยท ๐Ÿ’ฌ Discussion**

# ๐Ÿš€ Quick Start You'll need to have [Node.js](https://nodejs.org/en/) and [Yarn](https://yarnpkg.com/) installed. Then run the following commands to install dependencies and launch StableStudio. ```bash git clone https://github.com/Stability-AI/StableStudio.git ``` ```bash cd StableStudio ``` ```bash yarn ``` ```bash yarn dev ``` _**That's it! ๐ŸŽ‰**_ StableStudio will be running at [localhost:3000](http://localhost:3000) by default. > If you are using the default Stability API plugin, You'll need to have your [API key](https://platform.stability.ai/docs/getting-started/authentication) handy. Otherwise, you should be good to go! # About
StableStudio is [Stability AI](https://stability.ai)'s official open-source variant of [DreamStudio](https://www.dreamstudio.ai), our user interface for generative AI. It is a web-based application that allows users to create and edit generated images. We're not entirely sure where this project is going just yet, but we're excited to see what the community does with it! # FAQ ### What's the difference between StableStudio and [DreamStudio](https://dreamstudio.ai)? _Not much!_ There are a few tweaks we made to make the project more community-friendly: - We removed [DreamStudio](https://dreamstudio.ai)-specific branding. - All "over-the-wire" API calls have been replaced by a [plugin system](./packages/stablestudio-plugin/README.md) which allows you to easily swap out the back-end. - With a little bit of TypeScript, you can [create your own plugin](./packages/stablestudio-plugin/README.md) and use StableStudio with any back-end you want! - We removed Stability-specific account features such as billing, API key management, etc. - These features are still available at [DreamStudio's account page](https://dreamstudio.ai/account). ### Will [DreamStudio](https://dreamstudio.ai) still be supported? _Yes!_ Stability's hosted deployment of StableStudio will remain [DreamStudio](https://dreamstudio.ai). It will continue to get updates and stay up-to-date with StableStudio whenever possible. # ๐Ÿง‘โ€๐Ÿ’ป Contributing
_**Community contributions are encouraged!**_ **The UI package's [README](./packages/stablestudio-ui/README.md) is a great place to start.** Bug fixes, documentation, general clean-up, new features, etc. are all welcome. Here are some useful links... - [Discussion](https://github.com/Stability-AI/StableStudio/discussions) - [Open Issues](https://github.com/Stability-AI/StableStudio/issues) - [Open Pull Requests](https://github.com/Stability-AI/StableStudio/pulls) - [Code of Conduct](./CODE_OF_CONDUCT.md)