RESOURCES

Executable examples

The public kuztomer/inceptiva-sdk-examples repository contains standalone projects, separate from the portal and its private monorepo. They cover streaming, continuity, idempotency, citations, and paginated history.

Setup

Clone the repository and configure credentials only for the environment you intend to use:

bash

git clone https://github.com/kuztomer/inceptiva-sdk-examples.git
cd inceptiva-sdk-examples

export INCEPTIVA_API_BASE_URL="https://api.inceptiva.com"
export INCEPTIVA_AGENT_ID="AGENT_ID"
export INCEPTIVA_API_KEY="API_KEY"

Never place real keys in .env files, commits, screenshots, or tickets. The repository ignores every .env file.

JavaScript

An ESM Node.js example with streaming, citations, and history.

bash

npm install
npm run javascript

View javascript/index.mjs on GitHub →

TypeScript

A typed example with two-message continuity and collectStream.

bash

npm install
npm run typescript

View typescript/index.ts on GitHub →

Python

Uses the SDK published on PyPI and prints deltas as they arrive.

bash

python -m venv .venv
python -m pip install -r requirements.txt
python python/main.py

View python/main.py on GitHub →

.NET

A .NET 8 project with IAsyncEnumerable, streaming, and cancellation support.

bash

dotnet run --project dotnet/Inceptiva.Example.csproj

View dotnet/Program.cs on GitHub →

What you will learn

Create a response with a unique idempotency key.
Continue a conversation using conversationId.
Consume SSE deltas without retrying an initiated stream.
Read public citations and paginated history.
Keep API keys out of source control.