Get Started with CognOS
Build intelligent workloads with governance, memory, and reactive signals. Get CognOS running locally in 5 minutes.
Prerequisites
Local Dev Storage
Cosmos DB emulator or SQL Server with local storage for development.
Orleans Dev Setup
Standard Orleans development configuration (installed with CognOS).
Quick Start
1
Clone the Repository
git clone https://github.com/critical-insight-ai/CognOS
cd CognOS2
Build and Start
# PowerShell (Windows)
./scripts/build-and-start.ps1
# Bash (Linux/macOS)
./scripts/build-and-start.shCognOS will start on https://localhost:7287
3
Verify Installation
# Check health endpoint
curl -k https://localhost:7287/modules
# Expected: JSON array of loaded modulesYour First Admission Request
CognOS uses an admission pipeline to enforce governance before execution. Here's how to create your first request:
var admissionResult = await pipeline.EvaluateAsync(new AdmissionRequest
{
OperationKey = "analyze-document",
Principal = user,
Resource = documentId,
AmbientContext = new Dictionary<string, object>
{
["budget.requested"] = new BudgetVector
{
Dimensions = new()
{
["time"] = new Quantity(30000, "ms"), // 30 seconds
["tokens"] = new Quantity(5000, "tokens"), // 5000 tokens
["money:USD"] = new Quantity(0.50m, "USD") // $0.50
}
}
}
});
if (admissionResult.Verdict == AdmissionVerdict.Allow)
{
// Budget reserved, execute with active lease
await ExecuteWorkflow(documentId, admissionResult.LeaseId);
}