Does the AI agent run on my computer or in the cloud?
The agent runs on your computer. Tesseract installs agents such as Claude Code or Codex there and works on your files where they are. The AI model that writes the answers runs at the AI provider, such as your Claude or ChatGPT plan, unless you use a local model. You can also run agents on your other computers or a server, and reach them from the web app or the iPhone app.
Checked against Tesseract 0.12.5.
Where does the agent run?
On your computer. Tesseract runs each agent itself, installed on your computer and signed in with its own account or key. It installs the ones you pick.
- Tesseract runs Claude Code, Anthropic’s agent, on your computer and puts the tools around it.
- It runs Codex, OpenAI’s agent, on your computer the same way.
- It works on your files where they are, on your computer.
- The desktop app is for Mac, Windows and Linux.
The editors run on your computer too. The spreadsheet opens, calculates and saves your workbooks on your computer, and they are not kept on Tesseract’s servers. The video editor renders on your computer.
Where does the AI model run?
At the AI provider that runs it, unless you use a local model. To answer you, what the assistant reads is sent to that provider.
Which provider depends on how you run the AI:
- Your Claude or ChatGPT plan. Sign in and Tesseract runs on it.
- An API key, such as a Gemini, Anthropic or OpenAI key.
- Tesseract’s own models. The free allowance includes AI through Tesseract. Through the Tesseract Gateway, models from every major maker are in one list.
Some AI work happens on your computer:
- Smart selection and background removal in the photo editor run on your own machine.
- Relight reads a photo’s depth on your computer, and Harmonize and Select Subject run on your computer too.
- A voice message you send in team chat is written down on your own computer, and the recording goes to no transcription service.
- A kept song’s tempo and key are measured on your computer.
Pictures and clips are made by AI models. When you make a video, each shot is made by a video model, Gemini Omni 1.2 Flash unless you choose another, and the shots are put together on your computer with captions, music and the narrator.
What leaves my computer?
What the assistant reads goes to the AI provider, unless you use a local model. Conversations are stored and processed in the cloud. For the full list, read the privacy policy.
What else the site and release notes say:
- Your provider keys are kept out of the app’s interface. If you sign in, they sync with your settings through your account.
- Files you send to other accounts are encrypted on your machine before they are uploaded.
- Your reflections (the people, products and places you call by @name) can stay on this computer only, or go to your account. Nothing goes up until you say so, and photos lose their location and camera details first.
- Traffic between your computers goes straight from one machine to another when the network allows. When it doesn’t, a relay passes it along, still encrypted. The relay can’t read your traffic, but it does see how much passes and when.
- Crash reports from tesseract-agent are on by default. Turn them off with
tesseract-agent crash-reports off. - Sponsored messages. Without a paid plan or a balance, Tesseract shows sponsored messages, even when you use your own AI account. The home page’s privacy answer and the privacy policy say what the ad partner receives.
Can I run the agent on another computer or a server?
Yes. Any machine you own can run agents for you: your laptop, an iMac in the back office or a Linux server. The command-line agent is tesseract-agent, for any Mac, Linux or Windows machine with Node 20 or newer.
- Install it:
npm i -g tesseract-agent "--allow-scripts=tesseract-agent,ffmpeg-static,node-datachannel,@homebridge/node-pty-prebuilt-multiarch" - Sign in with a one-time code in your browser:
tesseract-agent login - Run it as a background service:
tesseract-agent install - Check on it:
tesseract-agent status
Or add a computer from the app: My Computers → Add a computer shows a one-time code as a QR code, a link and ready-to-paste commands for a server. The code works once, for 15 minutes.
Good to know:
- Machines dial out, so there are no ports to open.
- Run in the foreground with
tesseract-agent run, the agent takes its framework from--engine, and runs Claude Code when you name none. Several agents can share one machine with--instance. - On Windows the agent runs as a task in Task Scheduler.
- My Computers shows every machine and what it is running. Files, Terminal and Remote desktop open straight from the row of each computer that is online.
Does my computer need to stay on?
The agent works on the computer it is installed on, so that computer needs to be running. Work carries on after you close the window. Once nobody is at any of your devices for 20 minutes, it answers its own questions and carries on, and leaves a report of every decision it made for you.
For work that goes on when your laptop is off, run it on a machine that stays on. A personal assistant, for example, runs on your computer, or on your own server so it answers when your computer is off.
Tesseract inside Claude or ChatGPT is the exception. Nothing runs on your computer there: Tesseract has each picture or clip made and hands you the file.
Can I use my agents from my phone or another computer?
Yes. The agents keep running on your computer, and you reach them from elsewhere.
- The iPhone app. Tesseract: AI Agents is free in the App Store. Start a conversation on any of your computers, answer its questions, approve its plan and talk to it by voice. It works with Tesseract on your computer. There is no Android app.
- Your browser. Use Tesseract at app.tesseract.dev, run by a computer of yours it is connected to.
- Remote Desktop. See and control any of your computers from another one. It connects directly when the network allows, and through a relay when it doesn’t. To let someone else in once, make a one-time code that works for 15 minutes, 1 hour (the default) or 1 day.
- A private network. Every computer you add reaches the others by name, wherever each one is.
- Every machine’s files. One Files view browses every computer you own as if its folders were local.
Does Tesseract work offline?
Partly. The AI needs its provider: unless you use a local model, what the assistant reads is sent to the provider that runs the model.
What works without a network:
- Installing. Complete builds for installing without a network are on the download page.
- The photo editor. Everything except the AI actions works offline: selections, painting, retouching, layers, filters, Develop, smart selection and background removal, once its model has downloaded the first time.
Questions
Does Tesseract run in the cloud?
The agent runs on your computer, and it works on your files where they are. The AI model runs at the AI provider, unless you use a local model, and conversations are stored and processed in the cloud.
Is my code sent to the AI?
What the assistant reads is sent to the AI provider that runs the model, unless you use a local model.
Can I run Tesseract on a Linux server?
Yes. Install tesseract-agent on a Mac, Linux or Windows machine with Node 20 or newer, sign in, and run it as a background service.
Do I need to open ports?
No. Machines dial out, so there are no ports to open.
Is there a phone app?
Yes, for iPhone: Tesseract: AI Agents, free in the App Store, works with Tesseract on your computer. There is no Android app.
Does my computer need to be on?
For the agent, yes: it runs on that computer, or on a server you keep on. For Tesseract inside Claude or ChatGPT, no.
More guides
- Use Claude Code, Codex and other coding agents in one appTesseract runs 14 coding agents in one free desktop app. Pick one for each conversation, switch any time, and sign in with your own plan or a key.
- How to add an MCP connector (MCP server) to TesseractAdd any MCP server to Tesseract by its address, its command or its JSON settings, or from the official registry. Every agent framework can use it.
- What does an AI task cost in Tesseract?Tesseract is free. Your Claude or ChatGPT plan, an API key or the free allowance runs the AI. Pictures and video use paid models.