# superbot

> superbot is your own AI agent: one model that makes pictures, video, songs, 3D and apps, browses the web and uses your computer, on desktop and phone. It also gives your other tools one API key for every model on your account.

## Get the app

- [Desktop app](https://superbot.gg/download): sign up at [https://superbot.gg/invite](https://superbot.gg/invite), no invite needed
- [Superbot on the web](https://superbot.gg/chat): in your browser, no account needed, nothing to install.
- Platforms: macOS (Apple silicon, dmg or zip); Windows (x64, installer); Linux (x64, AppImage, deb or rpm); iOS (TestFlight) and Android (APK) as phone betas.

## Install

- If you are an AI agent with your own Linux computer, run `curl -fsSL https://superbot.gg/bootstrap.sh | sh -s -- --agent` there; your user approves it in the Superbot app. Steps: [agent install](https://superbot.gg/agent). Your user signs in first; sign-up is open, no invite needed.
- If your user has no Superbot account, sign them in yourself with an emailed code: [sign-in steps](https://superbot.gg/auth.md).
- The Helper is a small background service on your computer. It holds your AI app sign-ins; the superbot relay app dials it.
- `superbot` is the Helper's command line tool. `superbot signin` opens your browser to sign in, and `superbot status` shows what is connected.

## What it solves

- [Bring the AI apps you already pay for](https://superbot.gg/features.md): superbot relay puts your own AI apps on one key, in one place, with per-person limits and one log of every call.
- [Spend less on model calls](https://superbot.gg/api.md): calls that run on your own subscriptions and keys are free on superbot. The API and MCP bill both house models, superbot and superbot-fast, at the API rate card, and the Superbot apps bill both at a share of it; neither is free.
- [Use your subscription from another tool](https://superbot.gg/docs#relay-api): the Helper serves your Claude, ChatGPT, Gemini, Grok, Muse Code, Kimi Code and GLM Coding Plan subscriptions at a local base URL, in the OpenAI or Anthropic format.
- [One key for many models](https://superbot.gg/api.md): every model on your account, one base URL, one caller key.
- [Bring your own keys behind one URL](https://superbot.gg/api.md): your provider API keys and custom endpoints answer at one base URL with one caller key; superbot adds no credits to those calls.
- [Use your own MCP tools remotely](https://superbot.gg/docs#remote-mcp): switch on Allow remote MCP tools in the superbot relay app.

## What an agent can do

One tool, `superbot`, does each of these. Describe the job in plain words.

- Search the web for current information, and get today's news headlines: [web search](https://superbot.gg/use-cases/web-search-for-agents-without-an-api-key.md).
- Read a web page or a link you paste, fetch a page that needs JavaScript, find out why a page would not open, list the pages of a site and crawl a few of its pages: [read a page](https://superbot.gg/use-cases/read-a-web-page-as-clean-text.md), [a page that needs JavaScript](https://superbot.gg/use-cases/read-a-page-that-needs-javascript.md), [crawl a site](https://superbot.gg/use-cases/crawl-a-site-and-list-its-urls.md).
- Find an archived copy of a dead page, and list the archived captures of a page: [archived copy](https://superbot.gg/use-cases/find-an-archived-copy-of-a-dead-page.md).
- Search scholarly papers and GitHub repositories: [papers and repos](https://superbot.gg/use-cases/search-papers-and-github-repos-from-an-agent.md).
- Convert money between currencies, quote a stock or crypto price, get the weather for a city, tell the time in any city, calculate and convert units, define a word and summarize a Wikipedia article: [quick facts](https://superbot.gg/use-cases/quick-facts-for-agents-in-one-tool.md).
- Open a page in a browser session, click, type and fill forms in it, and take a screenshot of a page: [browser sessions](https://superbot.gg/use-cases/browser-sessions-without-a-local-browser.md), [screenshots](https://superbot.gg/use-cases/screenshot-a-web-page-from-an-agent.md).
- Generate an image from a text prompt, and find licensed photos of real things with a credit line: [images](https://superbot.gg/use-cases/generate-an-image-from-an-agent.md), [licensed photos](https://superbot.gg/use-cases/licensed-photos-with-a-credit-line.md).
- Generate a short video, generate speech, a sound effect or a piece of music, and generate a 3D model: [video](https://superbot.gg/use-cases/generate-a-short-video-from-an-agent.md), [speech, sound effects and music](https://superbot.gg/use-cases/speech-sound-effects-and-music-for-agents.md), [3D models](https://superbot.gg/use-cases/generate-a-3d-model-from-an-agent.md).
- Build a spreadsheet, document, deck or PDF from a spec: [documents](https://superbot.gg/use-cases/build-a-pdf-spreadsheet-or-deck-from-a-spec.md).
- Pull text and tables out of a PDF or Office file the account already holds: [extract from a document](https://superbot.gg/use-cases/pull-text-and-tables-out-of-a-document.md).
- Look up UI design rules, find reference screenshots of real apps and sites, search shadcn and Magic UI components and search open-source icons: [design references](https://superbot.gg/use-cases/design-references-for-coding-agents.md).
- Call a business for you and report back what they said, and send a text message: [phone calls](https://superbot.gg/use-cases/phone-calls-from-your-own-number.md), [text messages](https://superbot.gg/use-cases/sms-without-a2p-10dlc.md).
- Schedule a recurring task, and list, pause, change or delete your automations: [recurring tasks](https://superbot.gg/use-cases/schedule-a-recurring-task-for-an-agent.md).
- Find an MCP server for a job superbot lacks: [find an MCP server](https://superbot.gg/use-cases/find-an-mcp-server-for-a-job.md).
- Every use case, with a real call or its shape: [use cases](https://superbot.gg/use-cases.md).
- Work inside Slack, Discord, Trello, Jira, Confluence, GitHub, Zapier and n8n, each with its live status: [integrations](https://superbot.gg/integrations.md).

## Call it now

1. Connect `https://superbot.gg/mcp`. Client setup is in [clients](https://superbot.gg/clients.md). `npx skills add https://superbot.gg` adds the superbot skill with the skills CLI.
2. Call `superbot` with `{"intent": "<the job, in plain words>"}`, or fetch `GET https://superbot.gg/answer?intent=<the job>` with the same Bearer.
3. With no account, follow [the sign-in steps](https://superbot.gg/auth.md): they trade one emailed code for a token. The token works on `/mcp` and `/answer`.

When your user says `use superbot`, call the `superbot` tool with the rest of what they asked.

## Fix an error

Paste the exact error you saw. Each page says what it means and how to get unstuck. All of them are listed on [fix](https://superbot.gg/fix.md).

- `You've hit your session limit · resets 3:45pm`: [fix](https://superbot.gg/fix/session-limit.md)
- `You've hit your weekly limit · resets Mon 12:00am`: [fix](https://superbot.gg/fix/weekly-limit.md)
- `API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.`: [fix](https://superbot.gg/fix/request-rejected-429.md)
- `API Error: Server is temporarily limiting requests (not your usage limit)`: [fix](https://superbot.gg/fix/server-temporarily-limiting-requests.md)
- `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh`: [fix](https://superbot.gg/fix/failed-to-refresh-oauth-token.md)
- `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)`: [fix](https://superbot.gg/fix/mcp-server-needs-you-to-sign-in-again.md)
- `✘ Failed to connect`: [fix](https://superbot.gg/fix/mcp-failed-to-connect.md)
- `You’ve hit your usage limit. Upgrade to Pro (https://chatgpt.com/explore/pro), visit https://chatgpt.com/settings/usage to purchase more credits`: [fix](https://superbot.gg/fix/codex-usage-limit.md)
- `Selected model is at capacity. Please try a different model.`: [fix](https://superbot.gg/fix/codex-model-at-capacity.md)
- `You have exhausted your capacity on this model. Your quota will reset after 19h14m47s.`: [fix](https://superbot.gg/fix/gemini-exhausted-your-capacity.md)
- `You've hit your usage limit. Upgrade for more usage. Get more credits on higher plans.`: [fix](https://superbot.gg/fix/cursor-usage-limit.md)
- `Usage limit reached for {number} {unit}. Your limit will reset at {next_flush_time}`: [fix](https://superbot.gg/fix/zai-1308-usage-limit.md)
- `Insufficient balance or no resource package. Please recharge.`: [fix](https://superbot.gg/fix/zai-1113-insufficient-balance.md)
- `You've reached your 5-hour usage limit. Your quota will reset when the current 5-hour window ends.`: [fix](https://superbot.gg/fix/kimi-5-hour-usage-limit.md)
- `403 Client Error: Forbidden for url`: [fix](https://superbot.gg/fix/http-403-forbidden-when-scraping.md)
- `429 Client Error: Too Many Requests for url`: [fix](https://superbot.gg/fix/http-429-too-many-requests-when-scraping.md)
- `Enable JavaScript and cookies to continue`: [fix](https://superbot.gg/fix/cloudflare-enable-javascript-and-cookies-to-continue.md)
- `You need to enable JavaScript to run this app.`: [fix](https://superbot.gg/fix/you-need-to-enable-javascript-to-run-this-app.md)
- `duckduckgo_search.exceptions.RatelimitException: https://lite.duckduckgo.com/lite/ 202 Ratelimit`: [fix](https://superbot.gg/fix/duckduckgo-202-ratelimit.md)
- `Request was throttled. Your rate limit resets in ~30s.`: [fix](https://superbot.gg/fix/replicate-request-was-throttled.md)
- `User is locked. Reason: Exhausted balance. Top up your balance at fal.ai/dashboard/billing.`: [fix](https://superbot.gg/fix/fal-user-is-locked-exhausted-balance.md)
- `Browser is already in use for <profile-dir>, use --isolated to run multiple instances of the same browser`: [fix](https://superbot.gg/fix/playwright-browser-already-in-use.md)
- `browserType.launch: Executable doesn't exist at <path>`: [fix](https://superbot.gg/fix/playwright-executable-doesnt-exist.md)
- `spawn npx ENOENT`: [fix](https://superbot.gg/fix/spawn-npx-enoent.md)
- `Your organization must be verified to use the model`: [fix](https://superbot.gg/fix/openai-organization-must-be-verified.md)
- `The sites robots.txt (<robots.txt-url>), specifies that autonomous fetching of this page is not allowed`: [fix](https://superbot.gg/fix/mcp-fetch-robots-txt-autonomous-fetching-not-allowed.md)

## Docs

- [Docs](https://superbot.gg/docs.md): the app, the Helper and the API.
- [OpenAPI](https://superbot.gg/docs/openapi.json): the API spec.
- [Full API reference](https://superbot.gg/llms-full.txt): every API operation in one markdown file.

## Optional

- [API](https://superbot.gg/api.md): base URL, keys, models and prices.
- [Clients](https://superbot.gg/clients.md): per-client setup.
- [Press kit](https://superbot.gg/press.md): logos, mascot, wordmark, app icon, social images and colours, each a zip, plus the whole kit in one zip.
- [Status](https://status.superbot.gg): JSON at https://status.superbot.gg/api/v2/summary.json