Quickstart for New Engineers
Get up and running in 10 minutes.
Prerequisites
Install the following tools before anything else:
# Azure CLI
brew install azure-cli
# GitHub CLI
brew install gh
# Docker (for building images locally)
brew install --cask docker
# Node.js 20+ (for frontend projects)
brew install node
# Python 3.11+ (for backend services)
brew install python@3.11
1. Log in to Azure
az login
# Select the subscription: AgentStack (62be6d5f-97a5-4764-9bc9-ceb85a39a1f4)
# Verify you're on the right subscription
az account show --query '{name: name, id: id}'
Expected output:
{
"id": "62be6d5f-97a5-4764-9bc9-ceb85a39a1f4",
"name": "AgentStack"
}
2. Log in to GitHub
gh auth login
# Choose GitHub.com → HTTPS → Browser
Clone any repo from the org:
gh repo clone agentstackai/<repo-name>
3. Log in to the Container Registry
# Main registry (auth stack + HITL)
az acr login --name ca45076245feacr
# Assistant agent registry
az acr login --name ca74e243f29aacr
4. View All Running Apps
az containerapp list --output table
5. Access the Admin Interfaces
| Service | URL |
|---|---|
| Keycloak Admin Console | https://keycloak.icydesert-76825898.southindia.azurecontainerapps.io/admin |
| APIM Developer Portal | https://portal.azure.com → API Management → cerebro-stg-apim |
| Azure Portal | https://portal.azure.com |
6. Key Repositories
| Repo | Purpose |
|---|---|
| hitl-frontend | Human-in-the-loop React dashboard |
| agentstack-marketing | Marketing site (agentstacktech.com) |
| ai-marketer-frontend | AI Digital Marketer UI |
| ai-marketer-backend | AI Digital Marketer API |
| agentstackai-docs | This documentation site |
Next Steps
- Read the Applications section to understand each service
- Read Operations → Deploy & Update before pushing changes
- Check Secrets Management before adding new env vars