Getting Started

Enterprise-grade platform that developers enjoy using.

Evaluate Kosmera fully locally. No database installation. No Docker required. No cloud account required. Install the CLI, create a new app, run it locally, optionally add AI Skills Packs, and deploy to Kosmera Cloud when you decide to ship.

Run locally in minutes

Zero infra setup MongoDB-based runtime Modular architecture Optional AI Skills Packs

What you’re evaluating

Kosmera is an application platform for teams building domain systems that must survive enterprise reality: governance, consistency, modularity, and long-term maintainability — without sacrificing developer experience.

Local-first evaluation

  • ✓ Build and run a full application locally
  • ✓ No database installation required - the CLI manages local persistence in development mode
  • ✓ Optional AI Skills Packs (agents/tools/workflows) for AI-assisted building

Prerequisites

You can get to a running app with minimal local setup.

Required

  • • .NET SDK (8.0+)
  • • Node.js
  • • Git (recommended)

Not required

  • • MongoDB installation
  • • Docker
  • • Cloud credentials

Install the Kosmera CLI

Choose either the .NET global tool (recommended) or the npm shim (wrapper around the .NET CLI).

Option A — .NET global tool

dotnet tool install -g kosmera.cli

Option B — npm shim

npm install -g kosmera

Verify

kosmera --version

Create your first app

Initialize a new application workspace. This sets up the solution structure, default modules, and local configuration.

kosmera init my-app
cd my-app

What this does:

  • • Generates a modular app structure (backend + UI shell)
  • • Registers core runtime modules
  • • Writes local development configuration
  • • Prepares persistence settings for development mode

Run locally

Start the full application runtime locally.

kosmera run

In development mode, the CLI:

  • • Starts the backend API
  • • Starts the UI shell
  • • Provisions and manages a local MongoDB instance automatically
  • • Stores data locally (project-scoped)
  • • Loads modules and registers metadata

Why this matters

You get a zero-setup local experience without sacrificing production realism: the persistence engine and runtime model match what runs in Kosmera Cloud.

Architecture snapshot

Kosmera is opinionated by design. The goal is to make the “right way” the easy way — with a model that stays consistent from local evaluation to enterprise deployment.

  • • Code-first entity modeling (no manual schemas)
  • • MongoDB-based persistence
  • • Explicit relationships (typed references) instead of hidden magic
  • • Modular composition (apps as a set of modules)
  • • Preferences and policies as first-class configuration
  • • Secrets referenced, not stored inline
  • • Optional AI Skills Packs for workflow assistance

Optional: enable AI Skills Packs

Skills Packs add AI-capable workflows (agents, tools, and orchestration) on top of the same runtime model. They’re optional — you can evaluate Kosmera without AI, then enable skills when you’re ready.

kosmera skills install default

AI boundaries

AI operates inside the Kosmera runtime boundaries. It does not control infrastructure, deployment, or security configuration.

Deploy to Kosmera Cloud

Deployment requires a Kosmera Cloud subscription. Use it when you decide to ship, scale, and operate with enterprise-grade controls.

kosmera deploy

Kosmera Cloud typically adds:

  • • Tenant isolation
  • • Managed persistence
  • • Secure secret storage
  • • Environment promotion (non-prod → production)
  • • Monitoring and observability
  • • Operational governance

Production parity

Local evaluation and cloud deployment share the same runtime model so you can move forward without architectural rewrites.

Next steps

Once you have your app running locally:

  • • Add domain entities and relationships
  • • Define policies and preferences
  • • Compose modules for your domain
  • • Enable Skills Packs if you want AI assistance
  • • Deploy to a sandbox and promote to production when ready