# macaroni

**Repository Path**: mirrors_microsoft/macaroni

## Basic Information

- **Project Name**: macaroni
- **Description**: macaroni makes macaros ... aka macros ("any trigger" ==> "any action" ... w/ AI)
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# **mac**a**ro**ni

```C#
assert("macro" == "macaroni".Remove('a').Trim('n', 'i')) // ("any trigger" ==> "any action" ... w/ AI)`  
```

## _What is a **macro**?_  
A *macro* is an "action" or set of "actions" that you can use to perform repetitive, difficult, or hard to access tasks.  

## _What is **mac**a**ro**ni?_

*Macaro*ni is a high performance, user friendly *macro system*, designed to be used on PCs, Phones, and IoT devices.  
*Macaro*ni integrates w/ and utilizes open ai, carbon speech sdk, carbon vision sdk, as well as other Azure Services.  
*Macaro*ni is a modern dotnet 6.0 open source application, written in C# 10.0, for _Hackathon 2022_ ([project link](https://aka.ms/macaroni)).

![gist](todo/starter-code-blockly-html/gist.png)  
[docs](https://github.com/microsoft/macaroni/blob/main/docs/design.md) |
[install](#install) |
[build](#build) |
[contribute](#contribute) |
[more](#more)

 

---

## INSTALL

Pre-requisites:  
✔️ Azure subscription - Create one for free.  
✔️ Create a Speech resource in the Azure portal.  
✔️ Create a Translator resource in the Azure portal.  
✔️ Create an Open AI resource in the Azure portal.  
✔️ Get the resource key and region. After Speech resource is deployed, Go to resource to view keys.  
✔️ Get the resource key, region, and endpoint for Translation similarly...  
✔️ Get the resource key, region, and endpoint for Open AI similarly...  

Installation instructions:  
✔️ Download and run macaroni setup: https://crbn.us/macaroni.msi  
✔️ Create a file called `SPEECH_KEY` in the INSTALLATION directory, enter your Speech resource’s key (single line)  
✔️ Create a file called `SPEECH_REGION` in the INSTALLATION directory, enter your Speech resource’s region (single line)  
✔️ Create a file called `TRANSLATOR_KEY` in the INSTALLATION directory, enter your Translator resource’s key (single line)  
✔️ Create a file called `TRANSLATOR_REGION` in the INSTALLATION directory, enter your Translator's resource’s region (single line)  
✔️ Create a file called `TRANSLATOR_ENDPOINT` in the INSTALLATION directory, enter your Translator's resource’s endpoint (single line)  
✔️ Create a file called `OPEN_AI_KEY` in the INSTALLATION directory, enter your Open AI resource’s key (single line)  
✔️ Create a file called `OPEN_AI_ENDPOINT` in the INSTALLATION directory, enter your Open AI resource’s endpoint (single line)  
✔️ Create a file called `OPEN_AI_DEPLOYMENT` in the INSTALLATION directory, enter your Open AI resource’s deployment (single line)  
✔️ Run `macaroni.exe` – it will launch (without a top-level window; accessible in system tray)  

 

---

## BUILD

Pre-requisites:  
✔️ pre-requisites from [above](#install)  
✔️ `git` installed and available  
✔️ `dotnet 6.0` installed and available  
✔️ Visual Studio 2022 installed, including...  
✔️ ... C++ Desktop workload  
✔️ ... dotnet 6.0 Desktop workloads  

**Clone** instructions (using `Command Prompt`):  
```
cd \where\you\want\macaroni
git clone https://github.com/microsoft/macaroni
```

**Build** instructions (using `Developer Command Prompt for VS 2022`):   

```
REM Use `msbuild` not `dotnet build` due to native code for `hotkey:` trigger

cd \where\you\wput\macaroni
msbuild
```

**Build** instructions (using `VS 2022` interactively)  
✔️ Open `macaroni.sln` w/ VS 2022  
✔️ Build (Press `{ctrl-shift-b}`)  


 

---

## CONTRIBUTE

✔️ Join the Hackathon team ([link](https://aka.ms/macaroni))  
✔️ Join the Microsoft org ([link](https://eng.ms/docs/experiences-devices/webxt/microsoft-ads/bingadsplatform/bingadsui/bingadsui-onboarding-guide/development-guide/open-source-software-oss/developing-oss/join-microsoft-github-organization))  
✔️ Install ([link](#install)) or Build ([link](#build))  
✔️ Read the docs ([link](https://github.com/microsoft/macaroni/blob/main/docs/design.md))  

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](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

 

---

## MORE

✔️ Read the docs ([link](https://github.com/microsoft/macaroni/blob/main/docs/design.md))  
✔️ Check out the samples ([link](https://github.com/microsoft/macaroni/blob/main/src/Samples))  


This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
trademarks or logos is subject to and must follow 
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.