Skip to content

CapyAgent - a personal AI agent on your own machine.

AI assistant. For you or a small team

A personal AI agent that remembers you and does things for you in Telegram

It transcribes a call, sets reminders and sends a digest every morning. It is an AI assistant in Telegram, self-hosted on your computer or your server if you want to keep everything yourself, and an alternative to a ChatGPT tab. Runs on your computer or in our cloud. Free for yourself.

For yourself: an app for Windows, macOS and Linux, free. For a company: a morning digest from Bitrix24 and a separate server for the agent, connected on request.

For developers and servers: one-command install

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.”

02 / How it works

How it works, in three steps

01

Download the app

The wizard asks which model to use, tests it with a real request, and only then writes anything. About ten minutes, bot included. For a server there is a one-command install.

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: server 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.

  • 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.
  • Connections to work systemsBitrix24, Yandex.Direct and UIS (Comagic) telephony connect out of the box. Other services connect through extensions, which you can install from an archive right in the chat. 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. Or the cloud: a separate server for the agent at 1,590 RUB a month, connected on request. Prices are on the "Cloud and pricing" page.

05 / For developers and servers

For developers and servers: install by command

For a server, or if you like the terminal. On an ordinary computer it is easier to download the app.

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 or the cloud. The app is not signed yet, so on first launch the system asks once to confirm. 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.

06 / FAQ

Questions people ask

How is this different from ChatGPT?
ChatGPT is a chat in a browser or an app. CapyAgent runs on your side: it remembers you between conversations, runs jobs on a schedule, writes first in Telegram only to chats you named, and works with your business systems. History and notes stay on your machine. You choose the model, including a ChatGPT subscription, which connects with a code from your phone.
Can I run an AI assistant on my own server?
Yes. The agent installs on your server with one command and runs around the clock as a service. You need a server with Ubuntu or Debian and 2 GB of memory or more, and access to a model: a subscription, an API key, or a model on the same server through Ollama or LM Studio. If you would rather not keep a server, there is the cloud: a separate server for the agent at 1,590 RUB a month.
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 per month?
The program is free: install it for yourself or inside your own company and pay nothing for it. You pay only your model provider, for your own subscription or API key. In the cloud the server for the agent costs 1,590 RUB a month, the model is paid separately straight to the provider, about 2,000 RUB a month, so about 3,600 RUB a month together. There is no online payment yet: we send an invoice after your request. Setup help and support are sold separately, see the Pricing page.
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. To run it around the clock, put it on a server or take the cloud.
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.

Contact

Leave a Telegram handle or a phone number

We help with installation, the cloud or a rollout in your company. We answer within a working day.

We answer within a working day.

07 / Next

Install it and give it a first task

For yourself installing is free and needs no sign-up. If it does not fit, you remove one program, not a relationship with a service. Companies can take the cloud at 1,590 RUB a month.