Package Exports
- @simosphere/sdk
- @simosphere/sdk/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@simosphere/sdk) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@simosphere/sdk
Official TypeScript SDK for the SIMOSphere AI platform -- the European AI orchestration gateway by SIMO GmbH.
Installation
npm install @simosphere/sdkQuick start
import { SIMOSphereClient } from '@simosphere/sdk';
const client = new SIMOSphereClient({
apiKey: process.env.SIMOSPHERE_API_KEY!,
});
// Chat completion (OpenAI-compatible)
const response = await client.chat({
messages: [{ role: 'user', content: 'Hello from SIMOSphere!' }],
});
console.log(response.choices[0].message.content);
// List available models
const models = await client.models();
console.log(models.data.map((m) => m.id));
// Health check (no auth required)
const health = await client.health();
console.log(health.status);Configuration
| Option | Type | Default | Description |
|---|---|---|---|
apiKey |
string |
-- | API key from app.simosphereai.com |
baseUrl |
string |
https://api.simosphereai.com |
Gateway base URL |
timeoutMs |
number |
30000 |
Request timeout in milliseconds |
Convenience helpers
import { createChat, listModels } from '@simosphere/sdk';
// Functional style
const chat = createChat({ apiKey: '...' });
const res = await chat({ messages: [{ role: 'user', content: 'Hi' }] });
const models = await listModels({ apiKey: '...' });Error handling
import { SIMOSphereClient, SIMOSphereError } from '@simosphere/sdk';
try {
const res = await client.chat({ messages: [{ role: 'user', content: 'Test' }] });
} catch (err) {
if (err instanceof SIMOSphereError) {
console.error(`[${err.code}] ${err.message} (HTTP ${err.status})`);
}
}Links
- Platform: https://simosphereai.com
- API docs: https://simosphereai.com/de/developers
- OpenAPI spec: https://simosphereai.com/openapi.json
- MCP server: https://mcp.simosphereai.com
- Status: https://simosphereai.com/api/status
License
MIT -- SIMO GmbH, Aschaffenburg, Germany