Trifork.Aspire.Hosting.Corax 0.6.0

Corax hosting integration

Adds Corax Core to an Aspire AppHost. Corax runs locally with everything it needs, including local models, so no API keys are needed. It can also connect to a deployed Corax instead.

Getting started

The Corax images are private, so log the container runtime in to GitHub Container Registry with a token that can read packages:

gh auth refresh -h github.com -s read:packages
gh auth token | docker login ghcr.io -u <github-user> --password-stdin

Then add the package to the AppHost:

aspire add Trifork.Aspire.Hosting.Corax

Usage

const corax = await builder.addCorax("corax");

await builder.addProject("api", "../Api/Api.csproj")
    .withReference(corax)
    .waitFor(corax);

var corax = builder.AddCorax("corax");

builder.AddProject<Projects.Api>("api")
    .WithReference(corax)
    .WaitFor(corax);

The app receives CORAX_URI and CORAX_KEY, and starts once Corax's default models are registered.

Examples

Add the Corax web interface, signed in as a local administrator:

await builder.addCorax("corax").withFrontend();

Run your corax-backend clone with hot reload. It needs uv and ffmpeg, and ignores the clone's .env.local:

await builder.addCorax("corax").withBackend({ path: "../../corax-backend" });

Run your corax-frontend clone with hot reload. It needs bun, and signs in as a local administrator:

await builder.addCorax("corax").withFrontend({ path: "../../corax-frontend" });

Build the scanner from your clone:

await builder.addCorax("corax").withScanner({ path: "../../corax-scanner" });

Add the compliance scanner:

await builder.addCorax("corax").withScanner();

Pin versions instead of following latest (each repository has its own versions):

await builder.addCorax("corax")
    .withBackend({ version: "v2.358.0" })
    .withFrontend({ version: "v2.254.0" })
    .withScanner({ version: "v0.36.0" });

Use Azure OpenAI instead of local models (gpt-5.6-luna and text-embedding-ada-002 by default):

const key = await builder.addParameter("openai-api-key", { secret: true });

await builder.addCorax("corax").withAzureOpenAI("https://gpt-corax.openai.azure.com", key);

Serve Corax and its web interface on fixed ports (undefined keeps them random), and set environment variables on them:

await builder.addCorax("corax")
    .withBackend({ port: 8000 })
    .withFrontend({ port: 3000 })
    .configureBackend(async (api) => { await api.withEnvironment("ENABLE_EVALUATION", "true"); })
    .configureFrontend(async (frontend) => { await frontend.withEnvironment("PUBLIC_TTYD_URL", "http://localhost:7681"); });

Use an existing database, for example to keep data from another setup. Set the password with Aspire's withPassword:

await builder.addCorax("corax", { database: { name: "postgres", volume: "corax_database_data" } })
    .configurePostgres(async (postgres) => { await postgres.withPassword(pgPassword); });

Run another PostgreSQL version than production's 16, or keep the database container running between AppHost runs for faster starts:

await builder.addCorax("corax").configurePostgres(async (postgres) => {
    await postgres.withImageTag("pg17").withLifetime(ContainerLifetime.Persistent);
});

Use a deployed Corax. The dashboard asks for its API key, which is saved per URL, so a key is never sent to another deployment:

await builder.addCorax("corax").runAsRemote("https://api.dev.corax.app");

What runs locally

• corax-api: Corax in development mode; its generated API key grants administrator access. Corax and its web interface send telemetry to the Aspire dashboard.
• corax-postgres, corax-storage: PostgreSQL 16 with pgvector, and Azure Blob Storage through the Azurite emulator, as deployed Corax uses. Their data is kept in volumes across restarts.
• corax-models: qwen3:8b and nomic-embed-text on Ollama. An installed ollama uses the GPU on macOS; otherwise it runs in a CPU-only container.
• corax-stt: speech-to-text with whisper.cpp. It needs whisper-server and ffmpeg (brew install whisper-cpp ffmpeg); without them, only speech-to-text fails.

Connection properties

The connection string has the format Endpoint={Uri};Key={Key}.

Feedback & contributing

https://github.com/trifork/corax-aspire-integration