In diesem Release
Zusammenfassung
Zusammenfassung
This release makes Kaeso one gateway for every kind of model, not only chat: images, video, speech, transcripts, music and sound effects, Gemini-format apps, thirteen new built-in providers, alias routes with fallbacks and splits, and an MCP portal per project. The updater now installs releases that change compose.yaml. These notes cover everything since the last stable release, the release candidates included. Read the breaking changes before you upgrade: installs that update from the console need a one-time installer run, and installs behind their own reverse proxy need new routes.
- 01#769#780
BreakingAn install of any earlier release, the release candidates included, has an updater that speaks protocol 1, so Instance › Updates calls it outdated: run the installer once with
--updatein the install's folder, and Update in the console works again from then on. The installer replacescompose.yamlonly when its hash matches the release's, keeps the old file and turns the updater on if it was off; the Upgrades page of the documentation has the command. - 02#829#834
BreakingA reverse proxy of your own in front of Kaeso must also send
/v1beta/(the Gemini API, with response buffering off) and/v2/(ElevenLabs' voice listing) to the gateway, and pass WebSocket upgrades on for ElevenLabs' realtime sessions. The bundled Caddy and the platform templates already do; the Domains and TLS page lists every path. - 03#647
BreakingProjects in an organization are all alike: there is no default project, Kaeso opens on the organization's overview, and new members join only the projects their invitation names.
- 04#710
BreakingKaeso no longer reads the
models_devsettings: rename a[models_dev]section to[kpmr]andKAESO_MODELS_DEV_SYNCtoKAESO_KPMR_SYNCbefore you upgrade, because a leftover[models_dev]section stops the gateway. - 05#868
BreakingThe request log keeps short timings in microseconds, so the Platform API and the CSV export rename
request_upload_ms,overhead_msandstream_progress.processing_mstorequest_upload_us,overhead_usandstream_progress.processing_us, and the CSV'sstream_processing_mstostream_processing_us, with no alias for the old names. Code that reads them divides by 1,000 for milliseconds;duration_ms,ttfb_msandstream_progress.first_byte_msstay in milliseconds. - 06#664#665#666#667#668#669#672#760#893
BreakingThe UI library exports only its documented components and folds many of them into variants: aliases and internal parts are no longer public, StatusDot is now Status, and IconButton, SearchInput, SensitiveInput, FilterToggle, Gauge, ParameterPopover, DeleteResource, PromptSuggestions and the components that only wrapped another one are removed; ResponseMetrics no longer takes
reasoning. - 07#849
BreakingIn
kaeso-kpp,Base64Source::dataholds the decoded bytes asbytes::Bytesinstead of base64 text, so code that builds or reads media sources changes; KPP's JSON form is unchanged.
Hinzugefügt43
Hinzugefügt
- 01#649#650
Aliases route requests: fallbacks, conditions and weighted splits by request, caller or header, built in a full-page route editor with templates and a Test tab that sends a request through the draft and colors each step by its answer. A request's trace shows the path it took, and the
kaeso-routeheader names every step it tried. - 02#690#691
Every project has an MCP portal at
/mcp/{project}that serves its enabled tools to MCP clients, through an API key with thetoolsability or a client that signs in with a Client ID Metadata Document and the person's consent. Portal tokens work only at their own portal, disconnecting a client revokes its tokens at once, and held, switched-off or denied tools are refused. - 03#682#683#686#687
Organizations connect remote MCP servers over Streamable HTTP, signed in with a sealed secret header or OAuth with PKCE, and Kaeso reads and writes MCP messages of every protocol version from
2025-03-26to2026-07-28. Private networks are reached only whenmcp_servers.allowed_networkslists them, and secrets and tokens are sealed by the master key. - 04#688
Kaeso keeps each MCP tool's definition and syncs it on
mcp_servers.sync_interval; with the defaultholdpolicy a changed tool is hidden and refused until someone approves the new definition,acceptapproves changes on its own, and rejecting a tool switches it off in every project. - 05#685#689#696
New
mcp_servers.*andtools.*rights, in every role and agent preset, govern server management, tool review, access and use. The Platform API manages MCP servers, project tools, per-principal access and connected portal clients, with an audit entry for every change, and its Playground routes call a project's tool withPOST …/tools/{tool}/callunder the portal's approval, access and rate rules. - 06#693#694#738#745
Organization › MCP servers adds servers, probes their address, signs in and reviews definition changes with a diff. Project › Tools turns servers and tools on, one by one or a whole server at once, sets who may call them, connects or disconnects clients and sorts servers by name, calls, last use or tools on, and the consent page sums up a client's tools per server.
- 07#695
Servers that need a personal account work through Account › Connections: each person connects their own, the server's sync uses the latest working connection, and leaving an organization removes that person's connections and portal grants.
- 08#692#844#870
Tool calls appear in the request logs, usage and the project overview, and a
tool_call_ratelimit caps them per sliding minute for a project, member or key. The Tools tab of the request logs has live updates, every filter the Models tab has and an export to CSV or JSON Lines with each call's arguments and results. - 09#699#700#746
Kaeso emails the people responsible when something changes in an instance, organization, project or portal. Account › Notifications offers now, daily or off for each email a person's rights allow, a switch for the weekly summary and the monthly cost report, a mute per organization, a test email and a signed unsubscribe link, while security emails stay on.
- 10
- 11#670#718#719
An install can run as a public, read-only demo:
KAESO_AUTH_DEMO_USER, under the gateway's environment incompose.override.yaml, signs every visitor in as one user and refuses every change. Every console page then says it is read-only with sample data, each visitor sees only their own session, andmodels/offeredis refused before any provider is asked. - 12#675
Star on GitHub links to Kaeso's repository from the documentation's sidebar and from Instance › Updates, with the star count once it reaches 100.
Gateway
13–28- 13#799#801#835#859
Apps generate and edit images through OpenAI's Images API, with uploads and streamed partial images, on OpenAI, SpaceX, Google, OpenRouter, Vercel, Together AI, QwenCloud, Zhipu AI, MiniMax and ElevenLabs models, including QwenCloud's Wan and Z-Image models and ElevenLabs' GPT Image, Gemini and Seedream models. Keys, aliases, limits, budgets, logs and costs work as for every other model request.
- 14
- 15#815#816#818#822
Apps make videos through OpenAI's Videos API on SpaceX, Google AI Studio, Gemini Enterprise Agent Platform, MiniMax, Zhipu AI, OpenRouter, Together AI, QwenCloud and ElevenLabs. Kaeso keeps each job under an id of its own, asks the provider while it runs, streams the finished file and bills the job once, when it ends.
- 16
- 17
- 18
- 19
- 20#786#789#790
Google AI Studio and Gemini Enterprise Agent Platform are built-in providers. AI Studio takes an API key; Agent Platform takes an express mode API key or a service account key, which also reaches its Claude, partner and open models. Kaeso calls Gemini in its own format, so thought signatures survive tool loops in every app format.
- 21#808#837#901
ElevenLabs is a built-in provider. OpenAI-format apps reach its text to speech and Scribe through the Audio API, and apps built with the official ElevenLabs SDKs call its speech, voice changer, sound effects, music, transcription and image endpoints with a Kaeso key and open its realtime speech and transcription sessions, with Kaeso's limits, logs and costs.
- 22
- 23
- 24#804#812
Custom providers name the server software they run, one of fifteen such as vLLM, SGLang, Ollama, LM Studio, llama.cpp, LocalAI, Text Generation Inference, NVIDIA NIM or Docker Model Runner, so Kaeso sends each one what it expects. Models added from such a provider start with the context window the server lists and prices of 0; a provider with no named server software still gets no prices.
- 25#838
Custom providers serve OpenAI's images, speech, transcription and videos APIs once an admin turns each one on; a new provider for LocalAI, Xinference or vLLM starts with the APIs that software documents, and an API that is off is refused before sending.
- 26#883
Organizations and projects can keep the images, audio and files of logged requests, up to 10 MiB per request, with Keep media beside content logging, and the request inspector shows, plays and downloads them. It is off by default, and the organization's setting is the ceiling for its projects.
- 27#763
Usage and its timeline filter by model, provider, key, member, route and project, the timeline groups by them and reports latency, and the request log finds slow requests, so agents connected over MCP can analyse usage in depth.
- 28#798
Long prompts are billed at the model's long-context prices from KPMR, and a price override that sets a token price without its own tiers keeps one flat price for every prompt length.
Console
29–31- 29#762#886
Overview pages become homes, with the release the install runs, activity, spend, projects, members, keys, MCP servers and recent changes, and a new Analytics page shows usage by the minute and hour, per project, model, key and member. It leads with the period's totals and one readable chart, then what drives usage, reliability, efficiency and spend.
- 30#877#878#879
The Playground tries every kind of model, side by side from one prompt: chat, images, speech, sound effects, music, transcription with recorded or attached audio, and video with progress and Cancel. Chat takes images and PDFs by attaching, dropping or pasting them, and the Platform API sends each of these requests for a member.
- 31
UI library
32–33- 32#648
FlowCanvas and FlowWorkspace draw and edit routes as trees, with fallback chains, traced paths, badges and the answer of each tried step.
- 33
Documentation
34–36- 34#840
A new APIs by provider page shows which model APIs reach each of the built-in providers, from chat and embeddings to images, speech, transcription, video, music and sound effects, and says why where one is refused.
- 35#697
The MCP portal has its own concept page, guides for servers, tools and client sign-in and a portal API reference, in English, German and Chinese.
- 36
Self-hosting
37–43- 37#662#765#767
Kaeso installs with one installer command that downloads the newest release, writes its settings and master key and starts it. The installer starts a stopped Docker, checks the domain's DNS record and certificate, opens the setup link in your browser and turns the updater on, so Update in the console works from the first start.
- 38
- 39#727
GATEWAY_REPLICASruns several gateways behind Caddy in the Compose package, the updater replaces every replica, and a page says what gateways share. - 40#740
The gateway connects to Valkey over TLS, with
KAESO_VALKEY_CAfor a server whose authority is private. - 41#723
KAESO_SETUP_EMAILemails a one-time setup link at every start until the first user exists, for installs without a shell; it needs SMTP and never writes the link to the logs. - 42#724
The console image carries
kaeso-edge, a public edge for platforms that terminate TLS themselves and run the gateway and console as private services. - 43#725#741#751#752#754#814#819#885
Kaeso deploys from buttons in the README to Render, Railway, DigitalOcean, AWS, Google Cloud and Azure, and has templates and guides for Fly, Coolify, Dokploy and CapRover. Every template pins Kaeso's images to its release, the AWS templates are published with every release, the AWS quick server keeps its master key readable, and each guide says which paths were tested live.
Geändert27
Geändert
- 01#903
The Claude Code plugin adds only Kaeso's skill, which connects your install's MCP server when it isn't connected yet, so the plugin no longer asks for your install's address; the Cursor plugin keeps its MCP configuration in a folder of its own.
- 02#701#702#705#706#707#708#729
Dependencies are updated, among them
resvg0.49.0 anded25519-dalek3.0.0, with minor and patch updates of the Rust crates, the console, the documentation and the UI packages, and newer ClickHouse, Valkey, socket-proxy and distroless base images; the OSV scanner no longer ignores an advisory that matches nothing.
Gateway
03–09- 03#717#722#890
Alias routes hold a step after a lasting failure, such as a refused key, an empty balance or a rate limit, and skip it while a later step is ready when the step's
fall_back_onincludes the reason; every gateway of the install shares which steps are held. A route with a single step no longer asks Valkey, and skipped steps show in routes, logs, exports and metrics. - 04#712#759
Kaeso adapts what a model can't take instead of refusing the request: turning thinking off on a model that always reasons sends its lowest effort, an effort the model doesn't list becomes the nearest one it does, adaptive thinking becomes a thinking budget on Claude models without it, and a temperature a model can't take is left out, each named in
kaeso-adaptedorkaeso-left-out. An effort Kaeso doesn't know is still refused. - 05#828#847
When a provider answers 403, apps hear that the provider key may not make this request, for example for this model, plan or region, instead of that the key was refused; a 401 keeps the refused-key message. Apps in another format get 404 not found for a model the provider retired with a 410, where Anthropic- and Gemini-format apps got a server error; the provider's own format still gets its 410, and the model turns Unavailable in the catalogue when the provider no longer lists it.
- 06#882
Request logs no longer keep the images, audio and files inside chat requests, replies and tool calls, and show each as its type and size instead; Keep media keeps them where an organization wants them.
- 07#770#771#772#775#891#892
Requests no longer queue on shared locks for request-log flushes, usage rows or request ids, carry a 12 KB future instead of 33.5 KB, load a cold project's settings, models and limits at the same time while the body arrives, and never wait for the database for provider credentials, which refresh in the background.
- 08
- 09
KPP
10–11- 10
- 11
Console
12–16UI library
17–19- 17#660
Buttons press to 0.96, icons draw a 1.5px stroke and cross-fade when they change, and pictures get a translucent edge in their own shape.
- 18#664#665#666#667#668#669
Many UI library components take variants: Tabs, RadioGroup, Section, Skeleton and Kbd replace PillTabs, RadioCards, SettingsSection, SkeletonLine and KbdSequence; Stat, StatGroup, CopyButton and Avatar replace StatTile, StatGrid, MetricRow, ClipboardText, InlineCopyText, AgentAvatar, AgentAttribution and AvatarGroup; Button takes
pressed, Meter a gauge shape and ParameterPanel a trigger; an icon-only button is a Button with an icon that shows its name as a tooltip; and search, password and secret fields are types of Input. Aliases are gone, internal parts are no longer public, and StatusDot is now Status. - 19#773
Code blocks highlight 41 languages, loaded as they are needed, with a syntax palette that reads well in light and dark.
Documentation
20–26- 20#673#679#730#734#749#757#797#906
The README shows how to install Kaeso in one command and send a first request, how it compares with LiteLLM, Bifrost and Portkey, the console's pages in a theme-aware grid, the live demo, the OpenSSF Best Practices badge, one set of deploy buttons with the platforms' logos, and every built-in provider, with screenshots of the console as it is now.
- 21
- 22
- 23#904
The Images, Audio and Videos API pages name every newer provider, and the documentation's home page lists media, alias routes, the Playground and the MCP portal.
- 24#905
The READMEs of the UI library, the tokens, the codecs, the Claude Code plugin and the console describe what each one holds now, such as one import per UI library component.
- 25
- 26#824#827#831#836#855#862
The development pages describe a faster CI, which runs the gateway tests in four shards and each app's own suite only when it changed, and ask contributors to keep details of their own installs and provider accounts out of pull requests, issues and commits, as fixture notes and provider pages now do.
Self-hosting
27- 27#714
The Compose package gives the gateway time to drain on stop and room for connections, keeps steady connections from Caddy and sizes PostgreSQL from its container's memory.
Entfernt3
Entfernt
Gateway
01- 01#710
Kaeso no longer reads the
models_devsettings; a[models_dev]section stops the gateway until it is renamed to[kpmr], and the old environment variables are reported as unknown.
Console
02- 02#647
Projects in an organization are all alike: there is no default project, Kaeso opens on the organization's overview, and new members join only the projects their invitation names.
UI library
03- 03#672
The UI library drops the components that only wrapped another one: Menubar, Accordion, HoverCard, ProviderCard, EnvironmentSnippet, Grid, Stack, Inline, ThemeSelect, the page blocks and ResourceList.
Behoben18
Behoben
Gateway
01–08- 01#753
Claude Code sessions that connect an MCP server mid-session reach models in other formats, because Kaeso applies its inline tool changes to their tool list, and DeepSeek gets tool patterns it can compile.
- 02
- 03#851
Speech that fails before its first byte answers with an error in the app's format instead of an empty 200, and audio that breaks off ends in an error.
- 04#894
An image, speech or transcription model whose project's OpenAI key is a ChatGPT account says it needs an API key, in the Playground and on
/v1. - 05#888
The request log counts every keepalive a stream wrote, also while Kaeso holds back a tool call or leaves events out. A provider's own keepalive replayed to an app of the same format is not counted.
- 06
- 07
- 08#658
An alias whose route names a removed model can be renamed, and its 404 says no model is left for the request.
KPP
09- 09#876
An MP3 whose ID3v1 tag reaches back over its first frame no longer crashes the audio length reader.
Console
10–13UI library
14–16- 14
- 15
- 16#830
Diagrams in the docs no longer have a thin box drawn around them inside their card.
Documentation
17- 17#646
The request flow page gives the right answers for limits: no Retry-After for a used-up budget, 403 for a spend budget that can't price a feature, and 529 in the Anthropic format when the gateway is busy.
Self-hosting
18Sicherheit9
Sicherheit
- 01#826
Kaeso fetches an MCP client's metadata document only from a public address, whatever networks MCP servers may reach.
- 02#829
Voice and video ids can no longer steer provider calls, links on a host other than the provider's own are fetched from public addresses only, video and voice lookups count against rates, and
/v2reaches the gateway. - 03#747
The Render template keeps the client's address behind Render by reading the header Cloudflare sets instead of a forwarded one the caller can extend.
- 04#912
The gateway shares one memory budget, the size of
body_limits.in_flight, among all providers' answers, so large answers from a provider or a custom provider can no longer run it out of memory: a request that gets no room within 10 seconds is answered 503, and a stream that would need more than the budget ends with the stream limit's error. - 05#911
MCP portal clients meet the organization's two-factor and single sign-on rules and need the person's
tools.useright. Their grants and tokens stop working when the project is archived or the organization is scheduled for deletion, and a password change that signs agents out, or signing out everywhere, ends them too. - 06#914
A key with platform access creates and rotates keys only within its own model list, expiry and Tools access, and creates none while limits apply to it; a key can still rotate itself.
- 07#915
A key limited to some models no longer lists, reads, downloads, polls or deletes videos and image generations made with other models of its project.
- 08#916
Pending agent sign-ins for a client are capped per network, so requests from one network no longer end other people's, and client names drop invisible and direction-changing characters.
- 09#918
With Keep media off, a file a request sent where a media type belongs no longer stays in the request log inside the note that stands for it.































