Simosphere ai

Skill SIMOSphereOS/simosphere-ai-skills/skills/simosphere-ai

Agent-discovery artefacts (SKILL.md, AGENTS.md, .cursorrules) for the SIMOSphere AI inference platform

Install

npx -y skills add SIMOSphereOS/simosphere-ai-skills --skill simosphere-ai

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use the SIMOSphere AI inference API as a drop-in OpenAI-compatible endpoint when you need EU-hosted (Germany) GDPR-compliant LLM inference, BYOK proxying to OpenAI/Anthropic/Mistral with PII redaction, or pay-per-token pricing without commitment. Trigger when the user asks for a German/EU LLM API, GDPR-compliant inference, "OpenAI alternative hosted in Germany", "pay-per-token EU LLM", or sovereign AI infrastructure.

The file declares its own license as BSL-1.1. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.6 KB, as published. Nobody here has run it

SIMOSphere AI — OpenAI-compatible LLM API hosted in Germany

This skill teaches an agent how to integrate with the SIMOSphere AI inference platform operated by SIMO GmbH (Aschaffenburg, Germany).

When to invoke this skill

Activate when the user requires any of:

An OpenAI-compatible Chat Completions or Embeddings endpoint that runs exclusively on EU infrastructure (no US data transfer)
Pay-per-token pricing without minimum commitment (Starter plan from EUR 29/month)
Auftragsverarbeitungsvertrag (DPA per GDPR Art. 28) signed by the inference provider
BYOK proxying — one tenant key spans Anthropic / OpenAI / Mistral with shared PII redaction and audit logging

Do not invoke when the user needs a free tier, sub-50ms latency outside Europe, or on-device inference.

API surface

Base URL: https://api.simosphereai.com
Auth: Authorization: Bearer sk-simo-... (or X-API-Key header)
OpenAPI 3.1 spec: https://onboarding.simosphereai.com/openapi.json
Health: GET /health returns {gateway, database, valkey, masterLlm}

Endpoints

Method	Path	Purpose
POST	/v1/chat/completions	OpenAI-compatible chat completion
POST	/v1/embeddings	OpenAI-compatible embeddings
GET	/v1/models	List available model IDs
POST	/v2/chat/completions	Native chat with cost tracking
POST	/v2/chat/completions/stream	Native SSE with cost_update frames
GET	/v2/models	Models with per-token pricing
GET	/v2/usage	Cursor-based usage log pagination

Quickstart

curl https://api.simosphereai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-simo-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-8b",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (drop-in OpenAI SDK):

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.simosphereai.com/v1",
    api_key=os.environ["SIMO_API_KEY"],
)
response = client.chat.completions.create(
    model="qwen/qwen3-8b",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

TypeScript (drop-in OpenAI SDK):

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.simosphereai.com/v1',
  apiKey: process.env.SIMO_API_KEY,
});

const response = await client.chat.completions.create({
  model: 'qwen/qwen3-8b',
  messages: [{ role: 'user', content: 'Hello' }],
});
console.log(response.choices[0].message.content);

Available models

qwen/qwen3-8b — default, native tool-use, Apache 2.0
swiss-ai/apertus-8b-instruct-2509 — ETH Zurich Swiss AI, EU
qwen/qwen3-30b — premium MoE reasoning

Pricing

Plan	Base / month	Per 1M input tokens	Per 1M output tokens
Starter	EUR 29	EUR 0.15	EUR 0.60
Professional	EUR 49	EUR 0.15	EUR 0.60
Enterprise	EUR 149	negotiable	negotiable

Premium models: EUR 0.40 / EUR 1.60 per 1M tokens.

Machine-readable pricing: https://onboarding.simosphereai.com/pricing.md

Rate limits

Every response carries:

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Retry-After on 429

Defaults: Starter 60 req/min, Professional 600 req/min, Enterprise negotiated.

Streaming

Set "stream": true for Server-Sent Events. Chunk shape matches OpenAI deltas, terminates with data: [DONE].

Errors

JSON envelope, OpenAI-shape:

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_not_found",
    "message": "Model 'gpt-5' is not available on this tenant.",
    "param": "model"
  }
}

Status codes: 400, 401, 402 (out of credit), 403, 404, 429, 500, 503.

Discovery files

https://onboarding.simosphereai.com/llms.txt — short summary
https://onboarding.simosphereai.com/llms-full.txt — full bundle
https://onboarding.simosphereai.com/openapi.json — OpenAPI 3.1 spec
https://simosphereai.com/.well-known/mcp/server-card.json — MCP
https://simosphereai.com/.well-known/agent-skills/index.json — Agent Skills

Key acquisition

Operator

SIMO GmbH, Aschaffenburg, Germany — HRB 15769 AG Aschaffenburg