No-Panic Glossary
Every technical term, translated into plain English. Major terms use three views: beginner language, office version, and technical version.
VPS
Say it like I’m new: A VPS is a rented computer on the internet.
Office version: Headquarters.
Technical version: A virtual private server used to run agent services remotely.
Telegram
Say it like I’m new: Telegram is where you talk to the agent.
Office version: Front Desk.
Technical version: A messaging app used as the chat interface.
Termius
Say it like I’m new: Termius is the repair app used when something breaks.
Office version: IT Room.
Technical version: An SSH client used to connect to a server terminal.
Tailscale
Say it like I’m new: Tailscale is a private connection, similar to a VPN.
Office version: Private Hallway.
Technical version: A secure private network between your devices and servers.
VPS vs VPN vs Tailscale
Simple version:
- VPS = the cloud computer where services run.
- VPN = a private network connection.
- Tailscale = a tool that creates a VPN-like private connection.
Office version:
- VPS = Headquarters.
- VPN = private road.
- Tailscale = the Private Hallway tool that helps you safely reach Headquarters.
Simple meaning: A rented computer in the cloud.
Why it matters: Your AI agent services can run there all day, even when your personal device is off.
Think of it like: The building where the agent goes to work.
Common mistake: Thinking the VPS is a program. It is not. It is the computer/server where programs run.
A secure way to unlock and enter your Headquarters from a distance.
Why it matters: Without the key, you cannot reach the IT Room to fix things.
A text-based workspace where you type instructions to control services and check status.
Why it matters: This is where repair commands are entered. It looks plain but it is powerful.
An app on your phone or computer that connects you to the Command Desk inside Headquarters.
Why it matters: When the Front Desk is broken, you go to the IT Room to investigate.
A secure tunnel that connects your devices privately so only you can reach Headquarters.
Why it matters: If the hallway is closed, your connection to Headquarters may fail.
A small program inside Telegram that listens for your messages and passes them to the agent.
Why it matters: If the receptionist is asleep, your messages never reach the agent.
A secret code that proves your bot is the real receptionist. Given by Telegram when you create a bot.
Why it matters: If the password is wrong or changed, the receptionist cannot log in.
A secret credential that lets your agent talk to an AI service (like an LLM provider).
Why it matters: If the badge expires or is revoked, the agent cannot think or reply.
Invisible configuration values stored on the server that programs read when they start.
Why it matters: Tokens and keys often live here. If a drawer is missing, the agent may fail to start.
Text records of what the system and agents did, including errors and status messages.
Why it matters: When something breaks, the camera footage tells you what happened.
A program that runs continuously in the background, waiting to handle tasks.
Why it matters: If the worker stops, the agent stops responding until it is restarted.
Stopping a service and starting it again to clear temporary problems.
Why it matters: A restart fixes many issues without changing any settings.
A file that tells the agent how to behave, what model to use, and where to connect.
Why it matters: A typo in the rulebook can stop the agent from starting.
A numbered entry point on a computer that a specific service listens through.
Why it matters: If the wrong door is blocked, traffic cannot reach the service.
A system that blocks unwanted traffic and only allows approved connections.
Why it matters: A too-strict guard can accidentally block you or your agents.
A saved copy of your settings and data you can restore if something goes wrong.
Why it matters: Backups turn disasters into minor inconveniences.
A boxed environment that contains everything an agent needs to run, isolated from the rest of the system.
Why it matters: Containers make setups repeatable and reduce "it works on my machine" problems.
A command that starts, stops, checks, and manages background workers on Linux servers.
Why it matters: This is the main tool you use to check if an agent service is running.
A way for one service to instantly notify another when something happens.
Why it matters: Webhooks make Telegram bots respond immediately instead of waiting.
A method where a program repeatedly asks "anything new?" instead of waiting to be told.
Why it matters: Polling works without complex setup but uses more resources than webhooks.
A computer designed to run services and respond to requests from other computers.
Why it matters: Your VPS is a server. Your home computer can also act as one.
The amount of time a service has been running without interruption.
Why it matters: High uptime means your agent is reliably available.
A monitoring tool that automatically restarts a service if it stops responding.
Why it matters: Watchdogs reduce downtime by catching crashes quickly.
A software system that can receive instructions, process them using an AI model, and produce a response or action.
Why it matters: This is the core of your setup — the thing that actually thinks and replies.
A messaging app that acts as the clean, simple chat interface between you and your AI agents.
Why it matters: This is where you talk to your agents. If the Front Desk is closed, you cannot send or receive messages.