GA Chat

/ga chat — GA Chat Skill

Use this sub-command when you need to start the Guitar Alchemist chatbot locally, verify it is responding, or diagnose why it is not working.

When to Use

• User asks "is the chatbot working?"
• User says "start the chatbot" / "run the chatbot"
• Probing the chat endpoint before or after code changes
• CI is green but you want to confirm end-to-end locally
• Debugging why a chat request returns 404 or times out

---

Step 1 — Prerequisites Check

Verify all required tools are installed:

# .NET 10
dotnet --version   # must be 10.x

# Ollama (local LLM backend)
ollama --version
ollama list        # confirm a model is available (e.g. llama3.2)

# MongoDB (via Docker or local install)
docker ps | grep mongo
# OR
mongosh --eval "db.version()"

If Ollama has no models, pull one:

ollama pull llama3.2

---

Step 2 — Build the Solution

cd C:\Users\spare\source\repos\ga
dotnet build AllProjects.slnx -c Debug

Expected: Build succeeded. 0 Error(s)

If warnings fire for files you touched, fix them (IDE0305, IDE0022, etc.) per the C# coding standards.

---

Step 3 — Start All Services via Aspire

Architecture contract (non-negotiable):

• Aspire orchestrates: MongoDB (Docker), Redis, all microservices
• GaApi runs via dotnet run or via Aspire — never from a Docker image
• Ollama runs natively at localhost:11434 (not Docker)
• Aspire auto-injects ConnectionStrings__guitar-alchemist into GaApi; no manual MongoDB URL needed

pwsh Scripts/start-all.ps1 -NoBuild -Dashboard

This launches (via Aspire AppHost):

• MongoDB (Docker, dynamic port, data persists via ga-mongodb-data volume)
• MongoExpress UI at http://localhost:8081
• GaApi (REST + SignalR) — actual port shown in Aspire dashboard
• GaChatbot — internal Ollama-backed chatbot service
• Aspire Dashboard at https://localhost:15001

Wait ~30 seconds for all services to become healthy.