Skip to content
This repository was archived by the owner on Apr 8, 2025. It is now read-only.

microsoft/macaroni

Repository files navigation

macaroni

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 macaroni?

Macaroni is a high performance, user friendly macro system, designed to be used on PCs, Phones, and IoT devices.
Macaroni integrates w/ and utilizes open ai, carbon speech sdk, carbon vision sdk, as well as other Azure Services.
Macaroni is a modern dotnet 6.0 open source application, written in C# 10.0, for Hackathon 2022 (project link).

gist
docs | install | build | contribute | 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
✔️ 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)
✔️ Join the Microsoft org (link)
✔️ Install (link) or Build (link)
✔️ Read the docs (link)

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.

 


MORE

✔️ Read the docs (link)
✔️ Check out the samples (link)

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. 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.

About

macaroni makes macaros ... aka macros ("any trigger" ==> "any action" ... w/ AI)

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 8