COSINIA DEVELOPERS

Developers

Build applications on persistent Semantic Worlds using Cosinia APIs and SDKs.

GETTING STARTED

Quick Start

Cosinia lets applications create Semantic Worlds, observe knowledge, and perform deterministic Semantic Retrieval.

1. Create a World

Every application begins with an isolated persistent Semantic World.

2. Observe

Submit natural language or structured semantic observations.

3. Retrieve

Query deterministic semantic knowledge from the Semantic World.

</> Shell

npm install cosinia

INTEGRATION

Choose Your Integration

Cosinia supports simple SDK integration for applications and direct REST integration for infrastructure and advanced systems.

SDK

The fastest way to integrate Cosinia into an application.

Natural language observations
Structured semantic input
Simple application integration

REST API

Direct protocol access for infrastructure, pipelines, and enterprise systems.

Full API control
Structured requests
Advanced integration paths

SDK

JavaScript SDK

Use the SDK to create a world, observe knowledge, and retrieve semantic results through one interface.

</> JavaScript

import Cosinia from "cosinia";

const cosinia = new Cosinia({
    apiKey: "YOUR_API_KEY"
});

const world = await cosinia.world("my-world");

await world.observe(
    "John gave Mary a book."
);

const result = await world.retrieve(
    "Who received the book?"
);

console.log(result);

API

REST API

For direct integration, Cosinia exposes REST endpoints for world management, observation, semantic retrieval, and API access.

Endpoint	Purpose
POST /worlds	Create or manage Semantic Worlds
POST /observe	Submit observations
POST /retrieve	Perform Semantic Retrieval
GET /api-keys	Manage API credentials

</> Shell

curl https://api.cosinia.com/observe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "world_id": "my-world",
    "text": "John gave Mary a book."
  }'

CORE CONCEPTS

Platform Concepts

Concept	Meaning
Semantic World	An isolated persistent semantic universe.
Observation	A semantic assertion submitted into a Semantic World.
Semantic Compiler	Transforms observations into deterministic semantic structures.
Semantic Retrieval	Returns structured knowledge from persistent semantic memory.
API Key	Authenticates access to Semantic Worlds.

ENTERPRISE

Advanced Integration

Cosinia is designed to extend beyond predefined vocabularies and single-language use cases. The deterministic Semantic Compiler is contract-based, allowing organizations to introduce domain-specific semantics without changing the underlying engine.

Custom semantic contracts
Enterprise ontologies
Industry vocabularies
Language and domain expansion
Structured semantic input
Future embedded Andisheh Engine deployment

SECURITY

Execution Model

Cosinia is designed around isolated Semantic Worlds and deterministic computation. Enterprise deployments can extend this model with private infrastructure, secure execution, governance, and dedicated runtime environments.

NEXT STEP

Continue Building

You've seen how Cosinia integrates into applications. Continue with the complete documentation or explore the platform interactively in Semantic Studio.

Developer Resources

Browse SDK guides, REST APIs, Semantic Protocol specifications, and enterprise integration guides.

Read Documentation Open Semantic Studio