RAPP Brainstem

🧠

The Brainstem

Local agent server — the survival basics

Start here ▶

The biological brainstem keeps you alive — breathing, heartbeat, reflexes. Your AI brainstem does the same: it runs the core agent loop, calls tools, and responds. Everything else builds on top of this.

1. Authenticate with GitHub

Your GitHub Copilot subscription IS the AI engine. No OpenAI keys needed.

gh auth login

2. Start the brainstem

The server starts on port 7071 with a chat UI, health endpoint, and agent auto-discovery.

brainstem

3. Talk to it

Open localhost:7071 in your browser, or hit the API directly.

curl -s localhost:7071/health | python3 -m json.tool

4. Make it yours

Write a soul.md to define its personality. Drop *_agent.py files into the agents folder to give it skills. Point SOUL_PATH and AGENTS_PATH in .env to your private files.

☁️

The Spinal Cord

Deploy to Azure — give it a cloud body

Next step ▶

The spinal cord connects your brainstem to the rest of your body. Deploying to Azure does the same — your agent is now always-on, reachable from anywhere, with persistent storage and monitoring.

1. Deploy Azure resources

One script creates everything: Function App, Azure OpenAI, Storage Account, Application Insights. All using Entra ID auth — no API keys.

curl -fsSL https://raw.githubusercontent.com/kody-w/rapp-installer/main/deploy.sh | bash

2. Or click to deploy

Use the ARM template to deploy directly from the Azure Portal.

3. Connect your local brainstem

Your local brainstem can now use Azure OpenAI and Azure Storage instead of GitHub Copilot. Update .env with your Azure endpoint, or keep running locally with Copilot — your choice.

What you learn: ARM templates, Azure Functions (Python), managed identity, RBAC, Azure OpenAI.

🤖

The Nervous System

Connect to Copilot Studio — reach into M365

Advanced ▶

Your nervous system extends your brain's reach to every part of your body — eyes, ears, hands. Copilot Studio does the same: it connects your agent to Teams, M365 Copilot, and the entire Microsoft ecosystem. Your brainstem becomes an enterprise AI.

1. Import the solution

The repo includes a Power Platform solution (MSFTAIBASMultiAgentCopilot_*.zip) that creates a declarative agent in Copilot Studio wired to your Azure Function.

2. Configure the connector

Point the Copilot Studio action to your deployed Azure Function endpoint. The agent you built locally now answers in Teams and M365 Copilot.

3. Ship it

Publish to your organization. Your brainstem — the same agent logic you tested locally — is now available to every user in your tenant.

What you learn: Copilot Studio, declarative agents, Power Platform solutions, Teams integration, enterprise AI deployment.