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
