CommunityRAPP

Getting Started with CommunityRAPP

This guide will help you deploy and run your AI assistant in under 5 minutes.

🎯 What You’ll Accomplish

By the end of this guide, you’ll have:

📋 Prerequisites

Required

Operating System Specific

Windows:

Mac/Linux:

🚀 Step 1: Deploy to Azure (1 minute)

Click the button below to deploy all Azure resources:

Deploy to Azure

What Gets Deployed

The deployment creates these resources:

Deployment Process

  1. Click the “Deploy to Azure” button above
  2. Sign in to your Azure account
  3. Fill in the required fields:
    • Subscription: Select your Azure subscription
    • Resource Group: Create new or use existing
    • Region: Choose a region (recommend: East US, West Europe, or Japan East)
    • Project Name: Give your project a unique name (e.g., “mycompany-ai-assistant”)
  4. Click Review + Create
  5. Click Create

⏱️ Deployment takes 3-5 minutes. You’ll see “Your deployment is complete” when finished.

📥 Step 2: Copy Setup Script (30 seconds)

After deployment completes:

  1. Click the “Outputs” tab on the left sidebar

    Click Outputs Tab

  2. Find and copy the entire script value:
    • Windows users: Copy windowsSetupScript
    • Mac/Linux users: Copy macLinuxSetupScript

    Copy Script Value

  3. Save the script to a file:
    • Windows: Save as setup.ps1
    • Mac/Linux: Save as setup.sh

🔧 Step 3: Run Setup Script (2 minutes)

Windows (PowerShell)

# Navigate to where you saved the script
cd C:\Users\YourName\Downloads

# If you get a security error, run this first:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# Run the setup script
.\setup.ps1

Mac/Linux (Terminal)

# Navigate to where you saved the script
cd ~/Downloads

# Make it executable
chmod +x setup.sh

# Run the setup script
./setup.sh

What the Script Does

The script automatically:

  1. ✅ Installs Python 3.11 (if not found - Windows only)
  2. ✅ Clones the CommunityRAPP repository
  3. ✅ Creates local.settings.json with YOUR Azure credentials
  4. ✅ Sets up Python virtual environment
  5. ✅ Installs all dependencies
  6. ✅ Creates run scripts (run.ps1, run.bat, run.sh)

Note: The script includes your Azure credentials embedded securely - no manual configuration needed!

▶️ Step 4: Start Your Assistant (10 seconds)

Windows

cd CommunityRAPP
.\run.ps1

Or double-click run.bat in the folder.

Mac/Linux

cd CommunityRAPP
./run.sh

You’ll see output like:

Azure Functions Core Tools
Core Tools Version:       4.x.x
Function Runtime Version: 4.x.x

Functions:
  businessinsightbot_function: [POST] http://localhost:7071/api/businessinsightbot_function

💬 Step 5: Test Your Assistant

  1. Open client/index.html in your browser
  2. Type a message: “Hello, what can you help me with?”
  3. Get an instant AI-powered response!

Option 2: Direct API Test

PowerShell (Windows):

Invoke-RestMethod -Uri "http://localhost:7071/api/businessinsightbot_function" `
  -Method Post `
  -Body '{"user_input": "Hello", "conversation_history": []}' `
  -ContentType "application/json"

curl (Mac/Linux):

curl -X POST http://localhost:7071/api/businessinsightbot_function \
  -H "Content-Type: application/json" \
  -d '{"user_input": "Hello", "conversation_history": []}'

Option 3: Test in Azure

The setup script outputs your Azure URL. Use it to test the deployed version:

# Your Azure URL looks like:
https://your-function-app.azurewebsites.net/api/businessinsightbot_function?code=YOUR_KEY

Test with curl or PowerShell (replace YOUR_URL):

curl -X POST "YOUR_URL" \
  -H "Content-Type: application/json" \
  -d '{"user_input": "Hello", "conversation_history": []}'

✅ Verify Everything Works

You should see a JSON response like:

{
  "assistant_response": "Hello! I'm your AI assistant. I can help you with...",
  "voice_response": "Hello! I'm here to help.",
  "agent_logs": "Session initialized...",
  "user_guid": "c0p110t0-aaaa-bbbb-cccc-123456789abc"
}

🎉 Success! What’s Next?

Your AI assistant is now running! Here are your next steps:

1. Customize Your Assistant

Edit personality in Azure Portal → Function App → Configuration:

2. Deploy to Microsoft Teams (Optional)

Want your team to use the assistant in Teams? Follow the Power Platform Integration Guide.

3. Create Custom Agents

Add specialized capabilities by creating custom agents. See Agent Development Guide.

4. Monitor Usage

Check Application Insights in Azure Portal for:

🛠️ Common Commands

Start the Assistant

# Windows
.\run.ps1

# Mac/Linux
./run.sh

Stop the Assistant

Press Ctrl+C in the terminal

Update Dependencies

# Activate virtual environment first
# Windows
.venv\Scripts\activate

# Mac/Linux
source .venv/bin/activate

# Install/update packages
pip install -r requirements.txt

Deploy Code Changes to Azure

# Login to Azure (first time only)
az login

# Deploy to Azure
func azure functionapp publish YOUR-FUNCTION-APP-NAME

🚨 Troubleshooting

“Python 3.11 not found” (Windows)

Wait 2-3 minutes - the script auto-installs it! If it still fails, manually install from python.org.

“func: command not found” (Mac/Linux)

Install Azure Functions Core Tools:

npm install -g azure-functions-core-tools@4

“Port 7071 already in use”

Another process is using the port. Either stop it or change the port:

func start --port 7072

“Module not found” errors

Reinstall dependencies:

# Activate virtual environment first
pip install -r requirements.txt --force-reinstall

Setup script won’t run

Windows: Allow script execution:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Mac/Linux: Make script executable:

chmod +x setup.sh

For more issues, see the Complete Troubleshooting Guide.

📚 Learn More

💰 Cost Estimate

After free trial credits:

Total: ~$5/month + OpenAI usage

For typical usage (100 conversations/day), expect ~$10-20/month total.

🆘 Need Help?

Congratulations! 🎉 You’ve successfully deployed your AI assistant. Enjoy building with CommunityRAPP!

This site is open source. Improve this page.