Mibyan packages

Mibyan provides official packages for JavaScript, React, Python, and MCP integrations.

What are packages?

A package is ready-to-use code that connects your project to the Mibyan API. It handles common integration work so you can start with a few lines of code instead of building API requests, streaming, and error handling from scratch. If you only use the Mibyan product, you do not need to install a package. These packages are for developers adding Mibyan to an application, website, or tool.

Which package should I use?

Package	Use it for	Registry
`@mibyan/sdk`	Most JavaScript and TypeScript applications	npm
`@mibyan/react`	React chat interfaces and streaming UI	npm
`@mibyan/mcp`	MCP-compatible clients such as Cursor and Claude	npm
`@mibyan/core`	Advanced TypeScript integrations and libraries	npm
`mibyan-sdk`	Python applications	PyPI soon

Not sure? Start with @mibyan/sdk.

JavaScript and TypeScript

This is the recommended starting point for most developers.

npm install @mibyan/sdk

import Mibyan from "@mibyan/sdk";

const client = new Mibyan({ apiKey: process.env.MIBYAN_API_KEY! });
const result = await client.chat.completions.create({
  model: "mibyan-4.1",
  messages: [{ role: "user", content: "Hello" }],
});

console.log(result.choices[0]?.message.content);

For streaming, set stream: true and iterate over the returned async iterable.

React

Use @mibyan/react for React chat experiences with message, input, loading, error, and streaming state ready to use.

npm install @mibyan/react

See the package README for a useMibyanChat example. Keep API keys on your server, not in browser code.

Python

The Python SDK is ready in this repository and will be published to PyPI soon. For now, install it locally:

python3 -m pip install ./packages/python

MCP

MIBYAN_API_KEY=your-key npx @mibyan/mcp

The server exposes the mibyan_chat tool over MCP stdio. See authentication for key management.

How it fits together

Create an API key in Mibyan Platform.
Install the package that fits your project.
Pass the key to the package and call mibyan-4.1.
Use the returned text or stream in your application.

Guides

Endpoints

What are packages?

Which package should I use?

JavaScript and TypeScript

React

Python

MCP

How it fits together

​What are packages?

​Which package should I use?

​JavaScript and TypeScript

​React

​Python

​MCP

​How it fits together

What are packages?

Which package should I use?

JavaScript and TypeScript

React

Python

MCP

How it fits together