Airbolt SDK Documentation
Build secure AI-powered applications with our TypeScript and React SDKs. Production-ready, type-safe, and designed for developers.
🚀 Try Hosted Airbolt Beta
Skip the deployment! Get AI chat in your app with zero backend setup. No servers, no configuration, no hassle.
Join Private BetaDeploy Your Own Backend
Deploy your own private Airbolt backend in minutes. Get a secure LLM proxy with JWT authentication, rate limiting, and production-ready error handling.
🚀 One-Click Deploy to Render
The fastest way to get started. Click the button below to deploy your own Airbolt backend:
What you'll need:
-
A service name (becomes your URL:
my-ai-backend.onrender.com) - Your OpenAI API key (get one here)
Free tier note: Render's free tier sleeps after 15 minutes of inactivity. The SDK automatically handles cold starts with smart retries and extended timeouts.
After deployment, copy your API URL and use it with the SDKs below:
baseURL: "https://my-ai-backend.onrender.com"
Install the SDKs
Now that you have your backend deployed, install one of our SDKs to start building secure AI features:
Core SDK
TypeScript SDK for Node.js, browsers, and edge runtimes. Features automatic token management and full type safety.
React SDK
React hooks and components for building AI chat interfaces. The ChatWidget automatically inherits your app's styling (fonts, colors) and provides minimal CSS custom properties for theming.
Quick Start
# Install the SDK you need
# For React applications
npm install @airbolt/react-sdk
# For Node.js or vanilla JavaScript
npm install @airbolt/sdkimport { ChatWidget } from '@airbolt/react-sdk';
function App() {
return (
// ChatWidget inherits fonts, colors from parent
<div className="my-app-container">
<ChatWidget baseURL="https://your-api.onrender.com" />
</div>
);
}/* Your existing CSS - ChatWidget adapts automatically */
.my-app-container {
font-family: 'Inter', sans-serif;
color: #333;
/* Optional: Override chat-specific colors */
--chat-primary: #007aff;
--chat-surface: #f5f5f5;
}import { chat } from '@airbolt/sdk';
const response = await chat([
{ role: 'user', content: 'Hello, AI!' }
], {
baseURL: 'https://your-api.onrender.com'
});
console.log(response.content);Why Choose Airbolt SDKs?
Secure by Default
JWT-based authentication with automatic token management. Your API keys stay safe on the server.
Production Ready
Battle-tested with comprehensive error handling, retries, and TypeScript support.
Customizable
Pre-built components or build your own with our hooks. Full theming support included.
Well Documented
Complete API references, examples, and guides to get you started quickly.
More Examples
Contributing
Want to contribute to Airbolt? Check out our development guide.
Contributing Guide