Refactored the build instruction into its own file

This commit is contained in:
Thorsten Sommer 2024-06-23 19:20:29 +02:00
parent f83d21f070
commit a66ef9a9b2
Signed by: tsommer
GPG Key ID: 371BBA77A02C0108
2 changed files with 21 additions and 13 deletions

View File

@ -37,19 +37,7 @@ Here's an exciting look at some of the features we're planning to add to MindWor
Stay tuned for more updates and enhancements to make MindWork AI Studio even more powerful and versatile 🤩.
## Building
You just want to use the app? Then simply [download the appropriate setup for your operating system](documentation/Setup.md). This chapter is intended for developers who want to modify and customize the code.
In order to build MindWork AI Studio from source instead of using the pre-built binaries, follow these steps:
1. Install the .NET 8 SDK.
2. Install the Rust compiler.
3. Install NuShell. This shell works on all operating systems and is required because the build script is written in NuShell.
4. Clone the repository.
5. Open a terminal with NuShell.
6. Navigate to the `/app/MindWork AI Studio` directory within the repository.
7. To build the current version, run `nu build.nu publish`.
- This will build the app for the current operating system, for both x64 (Intel, AMD) and ARM64 (e.g., Apple Silicon, Raspberry Pi).
- The setup program will be located in `runtime/target/release/bundle` afterward.
8. To prepare a new release, run `nu build.nu prepare <ACTION>`, where `<ACTION>` is either `patch`, `minor`, or `major`.
You want to know how to build MindWork AI Studio from source? [Check out the instructions here](documentation/Build.md).
## License
MindWork AI Studio is licensed under the `FSL-1.1-MIT` license (functional source license). Heres a simple rundown of what that means for you:

20
documentation/Build.md Normal file
View File

@ -0,0 +1,20 @@
# Building
You just want to use the app? Then simply [download the appropriate setup for your operating system](Setup.md). This chapter is intended for developers who want to modify and customize the code.
In order to build MindWork AI Studio from source instead of using the pre-built binaries, follow these steps:
1. Install the [.NET 8 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
2. [Install the Rust compiler](https://www.rust-lang.org/tools/install) in the latest version.
3. [Install NuShell](https://www.nushell.sh/). This shell works on all operating systems and is required because the build script is written in NuShell.
4. Clone the repository.
5. Open a terminal with NuShell.
6. Navigate to the `/app/MindWork AI Studio` directory within the repository.
7. To build the current version, run `nu build.nu publish`.
- This will build the app for the current operating system, for both x64 (Intel, AMD) and ARM64 (e.g., Apple Silicon, Raspberry Pi).
- The setup program will be located in `runtime/target/release/bundle` afterward.
8. In order to create a new release:
1. To prepare a new release, run `nu build.nu prepare <ACTION>`, where `<ACTION>` is either `patch`, `minor`, or `major`.
2. The actual release will be built by our GitHub Workflow. For this to work, you need to create a PR with your changes.
3. Your proposed changes will be reviewed and merged.
4. Once the PR is merged, a member of the maintainers team will create & push an appropriate git tag in the format `vX.Y.Z`.
5. The GitHub Workflow will then build the release and upload it to the [release page](https://github.com/MindWorkAI/AI-Studio/releases/latest).
6. Building the release including virus scanning takes about 2 1/2 hours.