Installation and initial setup

Obtain the right revision

The canonical repository for the complete code is https://github.com/odahan/MAF-Course-Code. Keep its full tree: the solution is at repository root, with no additional BaseTechnique subdirectory. Download the archive of the revision linked by the course or clone the repository and select that SHA. Copying one demo folder omits shared projects and centralized versions.

git clone https://github.com/odahan/MAF-Course-Code.git MAF-Course-Code
Set-Location MAF-Course-Code
git checkout --detach 9a895c94534cd5fc6f3da883e37e5f7856e588c1
git rev-parse HEAD

Cloning needs Git and network access; a complete archive is the alternative. After extraction, open PowerShell in the directory containing BaseTechnique.slnx, global.json, Directory.Packages.props, demos and shared. That directory can have any name. All following commands start at this root.

Restore and build

dotnet --version
dotnet restore BaseTechnique.slnx -m:1 --configfile NuGet.Config --locked-mode --disable-parallel
dotnet build BaseTechnique.slnx -m:1 -c Release --no-restore
dotnet test BaseTechnique.slnx -m:1 -c Release --no-build --no-restore

Check the SDK before changing a project to work around an error. Projects include packages.lock.json files: --locked-mode rejects a different resolution. --no-restore separates build and restore; --no-build executes existing binaries. All build/test commands explicitly limit MSBuild with -m:1.

Lot-005 evidence covers a clean extraction of the reconstructed local candidate: 79 projects built and 241 tests passed. Its code files match the linked SHA; the prepared MIT notices are not yet published there. This is not a new download test or a new model qualification. Detailed logs remain private.

First model-free execution

dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- show
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- validate
dotnet run --project demos/Demo010_CodeOrAgent/Demo010.App.csproj -c Release --no-build

show displays settings and validate checks stored consistency. Neither tests the network or model capabilities. Default Demo010 computes a discount, explicitly routes a request to Auth and exits before creating the chat client. This separates an SDK problem from an AI service problem.

Prepare live calls

ollama list
ollama pull granite4:3b
ollama pull embeddinggemma:300m
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- check chat
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- check embeddings

To follow the distributed local profile, install and start Ollama separately, then provision the required models. The pull commands download models; embeddings are needed only for exercises that use them. check chat and check embeddings each send a live request to the saved profile. If you explicitly select an API profile, these requests go to the configured API service.

• Central configurator

• Connections and capabilities

Diagnose without changing the scenario

Restore fails if packages are unavailable; --no-build fails without binaries. A stopped service, missing model, wrong endpoint or missing key does not trigger cloud fallback. Use an isolated working database and profile; programs do not reset your data. The course requires neither Qdrant nor Docker. Later RAG uses Microsoft.Data.Sqlite, real vectors and exact C# cosine.

Continue the path

• Demo010 — Code or agent

• Code, workflow and agent

• Demo020 — Connection Profiles