Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Developer setup

You can open this repo in GitHub Codespace/Docker to get the build environment needed.

• Go to https://github.com/microsoft/genaiscript
• Click on Code
• Select Create new Codespace

Manual setup

• Install Node.JS 20+ or using nvm
• Run yarn

yarn install --frozen-lockfile --prefer-offline

• Start the Run - sample Debugger to launch the sample project in debugging mode

Dependencies

• run yarn install to refresh the lock file
• run yarn gen:licenses to refresh the 3rd party licenses

Docs

Run docs to launch the documentation site.

yarn docs

GitHub Pages are automatically updated on new release; or thourh manual trigger at https://github.com/microsoft/genaiscript/actions/workflows/docs.yml .

Packaging

To compile and package the Visual Studio Code extension, run the package script.

yarn package

You will find the built package files, genaiscript.vsix and genaiscript.insiders.vsix, in the packages/vscode folder.

Release

Run the release script.

yarn release

Documentation basics

Start local server

yarn docs