Azure Terminal Copilot
A Python-based Azure CLI assistant that provides natural language processing capabilities for Azure commands, leveraging Azure MCP Server.
Prerequisites
- Python 3.11+ (as specified in pyproject.toml)
- Azure CLI installed and configured
- Ollama with a model downloaded
- uv for Python package management
- Azure MCP server installed and running
Installation
-
Clone the repo
bash git clone https://github.com/yourusername/azure-terminal-copilot.git cd azure-terminal-copilot -
Open the terminal and Start a virtual env with uv
bash uv venv -
Install packages using uv
bash uv pip install . -
Run Ollama and make note of its local address
- Run Azure MCP server and make note of its local address
- Rename
.env-sampleto.env - I provided dummy values there so make sure to update with the values that correspond to your locally running ollama, Azure MCP, and model you want to use
- Now you can run
python main.py
Learning
Once the program is running, try a few things:
- Try providing a query like 'list all my resource groups', is the command you expect to be executed being ran?
- Try different models, notice which ones perform better?
- Try tweaking the system prompt, how would you improve it?
Troubleshooting
- Make sure your azure cli is logged in, azure MCP uses that as auth
License
This project is licensed under the MIT License - see the LICENSE file for details.
