Before you begin
You need:- macOS desktop access.
- One provider API key that your deployment supports.
- A local folder where Rainy MaTE can read and write files.
Install the desktop app
1
Download the installer
Open the Rainy MaTE releases page and download the latest macOS package.
2
Install Rainy MaTE
Complete installation and try to open the app.
3
Allow app in macOS settings if blocked
If macOS blocks the app, follow
/users/install-desktop to allow the app from System Settings -> Privacy & Security.4
Grant folder access when prompted
The app needs explicit workspace access for file operations.
Configure an AI provider
1
Open provider settings
Go to
Settings -> Models in the left sidebar.2
Add your provider key
Paste your key and run validation.
3
Save configuration
Save the key so it can be used by agent tasks.
Set your first workspace
- Click
Add Folderin the sidebar workspace section. - Choose the project folder you want Rainy MaTE to use.
- Confirm that the folder appears as the active workspace.
Run your first task
- Open
Agent Chat. - Select a model and agent.
- Send a prompt such as:
- Approve or reject any Airlock-gated actions.
Continue
/users/first-workflowfor a full first-session checklist./features/autonomous-workflowsfor plan and approval behavior./users/troubleshootingif setup or execution fails.