Skip to content

CapyAgent - a personal AI agent on your own machine.

RUEN
Install

Personal AI agent. For you or a small team

An agent that remembers you and works in your Telegram

You message it in plain words, like a person. It remembers what you told it, runs tasks on a schedule, and turns voice notes and call recordings into text. It lives on your computer or your server, not in someone else's cloud.

$curl -fsSL https://capyagent.com/install.sh | sh

Linux, macOS, WSL2. No sudo. The setup wizard asks for a model and a bot and checks both with a real request. Windows (PowerShell): iwr -useb https://capyagent.com/install.ps1 | iex

Desktop app For business

Step-by-step install, with a 90-second video

CapyAgentonline · Telegram
Voice note, 11 min
Transcribed. Three things were agreed: send the estimate by Friday, move the meeting to Tuesday, confirm the delivery date. Set reminders?
Yes, Thursday 10:00
Done. I will message you here on Thursday at 10:00.

Example chat, numbers are made up.

  • Free for yourself and for your own company. You pay only your model provider
  • Commands and file editing are off until you switch them on
  • Your data stays on your machine

01 / What it does

What it does for you

Eight everyday jobs. You ask in words, in Telegram or in the app window.

01

Turns a voice note or a call recording into text and a to-do list

Send a long recording, get the text and a short summary: who promised what, by when. Transcription runs on your own machine.

You say: “Here is the call recording. List what was agreed.”

Files up to 2 GB are accepted when your own Telegram server is on. The setup wizard offers it.

02

Reminds you on time

The reminder arrives in the same chat, with exactly the words you gave.

You say: “Remind me Thursday at 10 to call the bank.”

03

Sends a digest every morning

This is not a reminder: at the set hour the agent does the work again and sends the result.

You say: “On weekdays at 9, tell me what is new on my tasks.”

04

Watches things and writes first only when needed

Silent while all is well. It writes first only to chats you named in advance.

You say: “Check my server disk every hour and message me only if it is over 90%.”

05

Finds it on a website and gives you the link

It opens the page, including pages that a script draws, and brings back the text with the link.

You say: “Find the price of this pump on the supplier's site.”

06

Reads a document and pulls out the point

Send a PDF, Word, Excel or a table. It can also build one: a Word file made from your notes arrives in the chat.

You say: “What are the amounts and deadlines here?”

07

Remembers, then remembers again

A week later, in another conversation, it knows. Fixing or forgetting also happens in words.

You say: “Remember: invoices go out on the fifth. Forget the old price.”

08

Does the job on your computer

It touches commands and files only if you switched that on. Even then it asks before anything that may be more dangerous than it looks.

You say: “Sort the photos in this folder by date.”

All capabilities by job

02 / How it works

How it works, in three steps

01

Install with one command

The wizard asks which model to use, tests it with a real request, and only then writes anything. About ten minutes, bot included.

02

Connect your Telegram

Create a bot with @BotFather, paste its token into the wizard, add your Telegram ID. Strangers cannot message the agent: an empty allow-list means "nobody".

03

Talk to it

A request, a voice note, a file. Anything risky happens only after your "yes", asked again every time.

Step by step, with the video: install guide.

03 / Why your own agent

Why your own agent, not a chat in a browser

01

It remembers you

Three separate layers: conversation history, notes on facts, and a short "portrait" read at the start of every conversation. Deleting a conversation does not delete the notes. You can see what the agent remembers and forget any item.

02

Your data stays with you

History, notes and tasks live in a folder on your machine. There is no telemetry. capyagent doctor --prove prints every address the program may ever contact.

03

You choose the model

A ChatGPT subscription, an API key from one of many providers, a model running on your own machine. If the main one fails, the agent switches to the backup.

04

Off by default, on when you decide

Command execution, file access and screen capture are off after install. You turn them on one by one.

04 / For business

For a small team

The same agent, installed on a company server. One per team, with access by person.

For business Talk to us
  • One agent for a teamAdd colleagues to the allow-list. A stranger gets no reply, the attempt is logged, and you let them in with a code. Memory and access are shared inside one agent: when people or clients must not share them, install a separate instance for each.
  • Rights per personEach person can be tied to a profile and a role: owner, admin, team manager, employee, auditor.
  • Connectors to work systemsBitrix24, Yandex.Direct and UIS (Comagic) telephony connect out of the box. Any other MCP server plugs in the same way. For the first week keep the agent read-only and open write access one tool at a time.
  • On your own serverAround the clock, no open ports to the internet, run as a systemd service.
  • Help if you want itBusiness diagnostics, a pilot on your data, ongoing support, hosted agent on request.

05 / Install

Three ways to install

One command

Linux, macOS, WSL2

$curl -fsSL https://capyagent.com/install.sh | sh

Installs into your home folder, no sudo, and starts the wizard right away. Prefer not to run blind? Download and read the script first.

Windows

PowerShell, not as administrator

$iwr -useb https://capyagent.com/install.ps1 | iex

Installs into your user profile, no administrator rights.

Desktop app

Windows, macOS, Linux

The same agent inside: chat, settings, Telegram setup in a window. While the window is closed the agent is off: for round-the-clock work use the service on a server. On first launch the system asks once to confirm an unfamiliar app: the download page shows what to click.

What you need

  • A Linux server (Ubuntu or Debian, x86_64 or arm64, 2 GB of memory or more) or your own computer
  • Access to a model: a ChatGPT subscription or an API key
  • A Telegram bot
  • Your Telegram ID
  • For transcribing voice notes 4 GB and 4 cores is better

Setup on a clean server in 90 seconds. Long waits sped up.

QuickstartDownload the appInstall guide

06 / FAQ

Questions people ask

What do I need to start?
A server or a computer, access to a model, a Telegram bot. Root is not required: the same command installs into your home folder.
How much does it cost?
Installing it for yourself or inside your own company is free. You pay your model provider: your own subscription or key. Hosting, setup help and support are sold separately. A CapyAgent-run model subscription is in development and cannot be selected yet.
Where is my data?
On your machine: history, notes, tasks, settings. Only what you connect leaves it: the request to the model and any service whose keys you added. No telemetry. Voice notes are transcribed on your machine, audio is not sent anywhere.
Which models can I use?
A ChatGPT subscription (sign in with a code from your phone), any OpenAI-compatible endpoint (OpenRouter, DeepSeek, Qwen, Kimi and others), an Anthropic API key, Gemini, plus a model on your own machine through Ollama or LM Studio. A Claude subscription cannot be used in place of an API key.
Do I need a VPN?
The wizard checks Telegram and your model with a real request. If one of them does not open from your server, it offers a proxy, or our VPN+ subscription, which carries only Telegram and the model, not the whole machine.
Can I run it without a server?
Yes. Install the desktop app on Windows, macOS or Linux, or run the same command on your own computer. One catch: while the computer is off or the app is closed, the agent is silent and schedules do not fire.
How do I update?
On your say-so: the agent does not look for updates on its own. Run sudo CAPYAGENT_UPDATE=1 /opt/capyagent/bin/capyagent update. It keeps the previous version and your data first and rolls back on failure.
Is it safe?
Anything that gives access to the machine (commands, files, screen capture) is off after install. A risky action runs only after a one-time "yes" that names the action. Destructive ones (wiping the disk root, a fork bomb) are refused in any mode. Strangers cannot message the bot. The limits live in code, not in a request to the model.
What does it not do?
It does not listen to your microphone. It does not watch your habits to make suggestions. It does not pay for you or use your bank. It writes first only to chats you named in advance, and no more often than the limit you set.
Can two people or a whole team use one agent?
Yes, add them to the allow-list. Each gets their own conversations, while memory and access are shared in one agent. If they must not be shared, run a separate instance.

07 / Next

Install it and give it a first task

Installing is free and needs no sign-up. If it does not fit, you remove one program, not a relationship with a service.

$curl -fsSL https://capyagent.com/install.sh | sh
Desktop app For business Ask a question