Skip to content

About

Official MisarDev SDK monorepo — TypeScript, Python, Go, Rust, Java, Kotlin, Swift, Ruby, PHP, C#, Dart, Flutter and CLI.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Misar.Dev SDKs

Official client libraries for the Misar.Dev API — create, build and deploy apps, manage their files, domains, environment variables and collaborators, start from templates, search your code, and call the OpenAI-compatible chat completions endpoint.

Every SDK covers the full public API surface: 21 resources, 106 methods and 3 Server-Sent Events streams, generated from one manifest (manifest.json) that is itself derived from the API's route tree — so no language can fall behind another, or behind the server. They speak only HTTPS and SSE, and authenticate with a Misar.Dev API key (mdk_…) — create one at misar.dev/settings/api-keys.

Install

Language Registry Package Install
TypeScript / JavaScript npm @misardev/sdk npm install @misardev/sdk
CLI npm @misardev/cli npm install -g @misardev/cli
Python PyPI misardev pip install misardev
Go module proxy github.com/Misar-AI/misardev-sdks/go go get github.com/Misar-AI/misardev-sdks/go
Rust crates.io misardev cargo add misardev
Java Maven Central io.misar:misardev <artifactId>misardev</artifactId>
Kotlin Maven Central io.misar:misardev-kotlin implementation("io.misar:misardev-kotlin:1.0.0")
Swift Swift PM MisarDev .package(url: "https://github.com/Misar-AI/misardev-sdks", from: "1.0.0")
Ruby RubyGems misardev gem install misardev
PHP Packagist misarai/misardev-php composer require misarai/misardev-php
C# / .NET NuGet MisarDev dotnet add package MisarDev
Dart pub.dev misardev dart pub add misardev
Flutter pub.dev misardev_flutter flutter pub add misardev_flutter

Each language directory has its own README with the full method reference and examples for that SDK.

The TypeScript SDK was previously published as @misar/dev (0.x). That package is deprecated — install @misardev/sdk.

Quick start

import { MisarDev } from "@misardev/sdk";

const dev = new MisarDev(process.env.MISARDEV_API_KEY);

const { project } = await dev.projects.create<{ project: { id: string } }>({
  name: "Coffee shop site",
});

for await (const chunk of dev.chat.completionsStream({
  model: "misar-online",
  messages: [{ role: "user", content: "Suggest a tagline for a coffee shop" }],
})) {
  process.stdout.write((chunk.data as any).choices?.[0]?.delta?.content ?? "");
}

Plan limits

Limits are enforced server-side against the plan that owns the API key, never in the client. A blocked call answers with code: "plan_limit_exceeded" and an upgrade offer — 402 when the feature is not on the plan, 429 with Retry-After when an allowance is spent. Every SDK detects it by that code (not by status), raises a PlanLimitError carrying the full offer, and never retries it. Ordinary throttles (429 without that code) and transient server errors are retried with backoff that honours Retry-After.

Releases

Versions are per-SDK. A bump to a language's manifest on main is tagged <language>/vX.Y.Z automatically, and that tag publishes to the registry. Go, Swift and PHP carry no manifest version: their release version is VERSION, and for them the git tag is the release — which is why Package.swift sits at the repository root and the Go module path carries the /go suffix. See PUBLISHING.md.

Links

Licence

MIT. See LICENSE.

About

Official MisarDev SDK monorepo — TypeScript, Python, Go, Rust, Java, Kotlin, Swift, Ruby, PHP, C#, Dart, Flutter and CLI.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages