stagewise-io/klex

stagewise-io/klex has 30 GitHub stars and 3 forks. Star changes are not measured yet. Last checked 2026-11-14 02:47 UTC. Last push 2026-11-13.

So werden diese Zahlen gemessen

30 Sterne 3 Forks

Gemessener Sternzuwachs

in 24h: Verlauf wird gesammelt
in 7 days: Verlauf wird gesammelt
in 15 days: Verlauf wird gesammelt
in 1 month: Verlauf wird gesammelt

Nettoänderungen in überlappenden Zeiträumen, keine Tagessummen. Fehlende Messwerte bleiben leer. Sterne zeigen Interesse, nicht Qualität.

Über uns

Meet Klex Bots - Your own team of digital coworkers. Fully autonomous agents that work like your team does. Self-hostable and model-agnostic.

Entwicklerwerkzeuge

README.md

Original

Isolated, observable, autonomous bots that excel at memory and self-improvement. Tools, machines and coding environments are connected via MCP.

Installation

Install & Connect to Klex Cloud:

You can self-host a Klex Bot and connect it to the Klex Cloud.

Start here: https://cloud.klex.bot and locally install the Klex Bot when prompted.

Why connect it to cloud?

The cloud provides OOTB app-integrations with bot-owned identities and push-notification support (E.g. @My-Bot-123 in Slack which wakes up on a DM or @mention). Your local Klex Bot still owns all the data and API keys for inference providers.

Without the cloud, you need to set up reverse-proxies like tailscale or ngrok to receive webhooks from integrations that should wake up your bot. Most of the integrations only exist in cloud, though!

Or install just the local Klex Bot:

macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/stagewise-io/klex/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/stagewise-io/klex/main/install.ps1 | iex

To install (or update an existing installation), then create, enroll, and run a cloud bot in the foreground:

curl -fsSL https://raw.githubusercontent.com/stagewise-io/klex/main/install.sh | sh -s -- --cloud-enrollment-token '<TOKEN>'
# Optional: append --cloud-base-url 'https://cloud.klex.bot'

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/stagewise-io/klex/main/install.ps1))) -CloudEnrollmentToken '<TOKEN>'
# Optional: append -CloudBaseUrl 'https://cloud.klex.bot'

The token triggers klex --create-bot --cloud-enroll-token <TOKEN> after successful installation and verification. The optional base URL is forwarded as --cloud-base-url <URL>; without it, Klex uses its normal URL resolution. A base URL alone does not start a bot. The installer releases its lock before starting Klex and stays attached until Klex exits; it does not install a background service. Do not combine enrollment with uninstall. Avoid putting real tokens in shared logs or shell history.

After installation, you can add models, providers and mcp servers via the Terminal UI or configure their entries in {data-directory}/config.json directly.

Sending messages to the bot requires a connected MCP server with support for mcp-extension-push-notifications.

Principles

A Klex Bot has one permanent session

All incoming messages enter the same durable default session. Wherever you chat with the bot, it has the same context. Extensions can explicitly create isolated child sessions when a background-task needs separate context, tools, or model behavior.

Klex bots are mcp-native

The core agent loop is built around mcp-support. Incoming messages are sent via mcp servers that implement mcp-extension-push-notifications. Realtime calling is implemented via mcp-extension-realtime-media.

Klex bots can't touch their host computer

During runtime, the Klex Bot process only accesses data in one dedicated, isolated data-directory on its host machine. Connections to outside environments and machines are established via MCP. By implementing MCP extensions, MCP servers can wake-up a Klex Bot (mcp-extension-push-notifications) or initiate a voice- and video-call (mcp-extension-realtime-media).

Klex bots learn and self-improve (and keep their learnings organized)

After every unit of work, a Klex Bot will reflect on its actions and conversations - it will create and organize learnings as skills to do the task more efficiently the next time and remember preferences.

You can voice-call Klex Bots

Voice conversations via latest realtime models are integrated out of the box. mcp-extension-realtime-media lets you initiate a call via MCP - and swill make the bot switch to an agreed-upon realtime protocol (so far, only LiveKit is supported).

Community

Join the Discord

License

Klex is licensed under the Apache License 2.0.