Skip to content
Docs
GitHub

Everruns Demo quickstart

Try the hosted demo with available promotional credit or your own provider keys, create a token, and connect from the SDK, CLI, or an AI tool.

4 min readEdit on GitHub

Applies toFramework (not available)Self-hosted (not available)Everruns Demo

Everruns Demo is a demo instance of the same open-source code you can run yourself. It is not a hosted service: use it to look around, then run your own with Docker Compose or Kubernetes. The demo runs the API, the workers, the database, and the UI for you. Explore with available promotional credit for built-in models, or connect your own provider keys.

This page takes you from sign-up to a first agent turn, then explains how credit works.

Open app.everruns.com and sign in. Verify your email address when asked. Open Settings > Billing to see any available promotional credit. Credit purchases and top-ups are unavailable.

Open Settings > Profile > Manage your Everruns ID, or visit id.everruns.com/account, to manage sign-in methods, security, sign-in sessions, and personal connections across your organizations.

Passkeys are an optional second factor after your password or Google sign-in. In Security, choose Add a passkey and follow your browser’s native prompt. Compatible browsers can use Apple Passwords, a mobile credential manager, a password manager, or a security key. Save the recovery codes shown after enrollment; each code works once after primary sign-in. Keep a backup passkey or recovery codes so losing a device does not lock you out.

Sessions shows signed-in devices, activity, and, for new sign-ins, masked IP addresses and approximate sign-in locations. Ending an ID session leaves an app’s separate session valid until its own expiry. Connections lists your ID-linked apps, approved AI clients, personal MCP servers, service connections, credentials, and API tokens, with revoke controls and recorded usage. Unknown usage is shown as unavailable.

New organizations come with the built-in model provider already set up. There are no keys to paste: create an agent in the UI and start a session, and its turns are charged against your organization’s credit.

The SDKs, the CLI, and the API authenticate with a personal access token. In the UI, open Settings > Personal Access Tokens and create one. Tokens start with evr_pat_ and are shown once, so copy it before you close the dialog.

A token belongs to your user account, not to one organization, and can reach every organization you belong to. Choose Read-only for scripts that only read; it still reads every organization you belong to (Token access). Revoke a token from the same page.

Pick the client you want. All three talk to https://app.everruns.com.

Install an SDK and set two environment variables:

Terminal window
pip install everruns-sdk
export EVERRUNS_API_KEY=evr_pat_...
export EVERRUNS_API_URL=https://app.everruns.com/api

Newer SDK releases default to Everruns Demo; setting EVERRUNS_API_URL keeps older ones pointed at it too. Then run one turn:

import asyncio
from everruns_sdk import Everruns
async def main():
client = Everruns() # reads EVERRUNS_API_KEY and EVERRUNS_API_URL
agent = await client.agents.apply_by_name(
name="hello", system_prompt="You are a concise assistant."
)
session = await client.sessions.create(agent_id=agent.id)
await client.messages.create(session.id, "Say hello in one sentence.")
print(f"Session: {session.id}")
await client.close()
asyncio.run(main())

The message starts a turn; the answer arrives as events. The SDK tutorial shows how to stream them.

The CLI uses Everruns Demo by default, so there is no URL to configure:

Terminal window
everruns login # opens the browser to sign in
SESSION=$(everruns sessions create -q)
everruns chat --session "$SESSION" "Say hello in one sentence."

everruns login signs you in through the browser, creates a personal access token for this machine, and asks which organization to use when you belong to more than one. On a machine without a browser, run everruns login --token and paste a token you created in step 3.

The everruns plugin connects Claude Code, Codex, and Cursor to Everruns Demo over MCP, at https://app.everruns.com/mcp. It signs in with OAuth on first use, so it needs no token. See Use in AI Tools.

The demo has no subscriptions, credit purchases, top-ups, or paid overage.

  • Balance. Settings > Billing shows the organization’s available credit and amounts held by work that is still running. Every organization member can see the balance. Historical purchased credit and refund records remain visible when present.
  • Built-in models. Requests use the organization’s available credit. When no credit is available, use your own provider keys or self-host Everruns to continue exploring. Work already in flight can still settle against its reservation.

This credit is separate from budgets. A budget is a limit you set on a session or an agent; credit is what pays for the built-in provider.

You can add your own provider API keys under Models > Providers, and point agents at those models. Calls through your own keys are billed by that provider, not against your Everruns credit, and keep working when the credit balance is zero.