Skip to main content

The Wisp Runtime

Wisp is an AI agent you run on your own machine. You install one program, wisp. It keeps your credentials and your conversations on that machine and does the work there. The model it talks to runs inside a trusted execution environment, so the files it reads are never visible in the clear on the way to the model.

There are two ways to use it, and both talk to the same Runtime:

  • From a terminal or a script. wisp run "…" sends a prompt and prints the answer, the way claude -p does.
  • Over HTTP. The /v1 API on 127.0.0.1 lets your own code (a chat bot, a webhook handler, a scheduler) turn its events into Runs.

If you also use Wisp Desktop on the same machine, the CLI talks to the Runtime inside the app while it is open, and your Sessions and connectors are shared between the two. The app can also work with a Runtime you run on a server, over SSH: see Connect to a server.

Where to go next​

You want to…Read
Install it and get a first answerQuickstart
Run it as a service, update it, remove itInstall, update, uninstall
Use it day to day from the terminalUsing the CLI
Know where a conversation's files live, and tie it to a folderSessions and Projects
Change a setting, open it to the network, pick the default modelConfiguration
Know what pays for a Run, top up the balancePlan and balance
Give the agent access to GitHub, Drive, your Telegram account, your own MCP serversConnectors
See which tools the agent hasTools
Decide which tools may run unattendedPermissions
Teach the agent a procedure, or give it standing instructionsSkills, Instructions
Run a prompt on a timetableSchedules
Send it voice, images and documents, get files backVoice and files
Talk to the agent from Telegram or SlackTelegram bot, Slack app
Run it on a server and use it from Wisp DesktopConnect to a server
Reach it from another machine, a token per deviceRemote access
Ship an agent as a folder you can check out on a serverDeploying an agent
Call Wisp from your own codeThe adapter contract and a worked example
Keep it runningRuns and restarts, Troubleshooting, Security
Look up a command, route or settingReference

Words used on this site​

  • Runtime: the running wisp serve process (or the one inside Wisp Desktop).
  • Session: one conversation. It keeps its history between Runs and across restarts.
  • Run: one prompt sent to a Session, and the agent's work until it answers.
  • Project: the folder a Session works in. The agent's file tools work there; a call outside it asks first (with the sandbox on, it is refused).
  • Connector: an MCP server that gives the agent more tools. The built-in Telegram connector signs in as your own account, so the agent can read it.
  • Channel: a messenger you write to the agent through: wisp telegram or wisp slack.
  • Rule: a decision (allow, ask or deny) for one tool, globally or for one Project.