智能代理操作系统

Debian / Ubuntu / Fedora / Arch / Alpine / macOS, one-line install

curl -fsSL https://raw.githubusercontent.com/jaylfc/tinyagentos/master/scripts/install-server.sh | sudo bash

Run without `sudo` to install as a user-mode systemd unit instead. The script is idempotent, safe to re-run on an existing install. Supports env-var overrides for install path, branch, and port.

**Manual / development:**

Open http://your-host:6969 (or http://taos.local:6969 with mDNS). The root URL loads the desktop shell directly.

Linux / macOS, one-line worker install (auto-detects headless,

installs as a system service when run with sudo or as a user

service otherwise; works on a fresh Debian install or your existing box)

curl -fsSL https://raw.githubusercontent.com/jaylfc/tinyagentos/master/scripts/install-worker.sh | sudo bash -s -- http://your-server:6969

Android, one-line Termux setup

curl -sL https://raw.githubusercontent.com/jaylfc/tinyagentos/master/tinyagentos/worker/android_setup.sh | bash

Windows 10/11, one-line worker install (PowerShell, mirrors the

Linux/macOS installer — registers a Scheduled Task so the worker

Agent Deployment

5-step wizard: pick framework → choose model → configure → deploy into an isolated container (LXC on bare metal, Docker on VPS, auto-detected). Each agent gets its own memory system (taOSmd instance), its own file storage, and its own network identity. The framework runs inside the container but TinyAgentOS manages everything around it: memory, channels, secrets, model access, scheduled tasks, and inter-agent communication. This means the framework is a swappable component, not a lock-in decision.

**Running taOS inside an LXC (e.g. Proxmox)?** Deploying an agent creates a nested container, which an unprivileged LXC cannot do — the kernel can't remap the nested container's filesystem, so the deploy fails with an idmapped storage / change ownership error. Run the taOS LXC as privileged with nesting enabled. On Proxmox: untick Unprivileged container and set Options → Features → nesting=1 (plus keyctl=1, fuse=1), then redeploy. Bare-metal and VM installs are unaffected. (taOS detects this and surfaces the fix in the deploy error.)

<p align="center"> <img src="docs/images/mobile-agents-empty.png" alt="Agents app empty state on mobile — one tap to deploy" width="30%"> </p>

<p align="center">_{The Agents app on mobile — one tap from empty to your first deployed agent.}</p>

What the install creates on your box

Full transparency on every file, service, user, and port the installers touch. Nothing is hidden behind a vendored binary; everything is plain Python, plain systemd, plain shell.

Controller install (`scripts/install-server.sh`)

Run curl -fsSL https://raw.githubusercontent.com/jaylfc/tinyagentos/master/scripts/install-server.sh | sudo bash on a fresh Debian / Ubuntu / Fedora / Arch / Alpine box to get the controller fully installed, repo cloned to ~/tinyagentos/, venv created, all deps installed, and both tinyagentos.service (port 6969) and qmd.service (port 7832) registered and started.

Worker install (`scripts/install-worker.sh`)

Verify what's installed

```bash

Worker side (after running install-worker.sh)

systemctl status tinyagentos-worker ls ~/.local/share/tinyagentos-worker/ ```

Uninstall

```bash

If you manually installed the RK3588 image-gen units:

Upgrading a long-running install

Controller (recommended): use the one-shot update script:

cd ~/tinyagentos
bin/update.sh

This pulls the latest, rebuilds the desktop frontend bundle if the source has moved (skips it when nothing changed), then restarts the service. The frontend rebuild takes ~50s when it fires; it is a no-op otherwise.

Manual equivalent:

```bash cd ~/tinyagentos git pull

which can confuse Python's .pyc cache invalidation on some setups)

find . -name pycache -type d -exec rm -rf {} + 2>/dev/null || true

Rebuild frontend if desktop source changed (omit if you didn't pull any desktop/ changes)

cd desktop && npm install && npm run build && cd .. sudo systemctl restart tinyagentos

The systemd unit also runs a conditional rebuild as an `ExecStartPre` step — if you skip the manual `npm run build`, the next service restart detects the stale bundle and rebuilds it automatically (~50s startup overhead when it fires).

**Worker:**

The bytecode cleanup line is belt-and-braces; Python's mtime-based invalidation usually works, but on long-running boxes that have survived many upgrades it occasionally doesn't, and a stale .pyc is easy to mistake for a code bug.

RK3588 NPU Setup

scripts/install-rknpu.sh is an opt-in automated installer for the full Rockchip NPU stack. It pins librknnrt to 2.3.0, installs the jaylfc fork of rkllama, and preloads three chat models. All binaries are fetched from huggingface.co/jaysom/tinyagentos-rockchip-mirror, a TAOS-controlled mirror, and SHA256-verified before installation. If any checksum fails the script hard-aborts.

curl -fsSL https://raw.githubusercontent.com/jaylfc/tinyagentos/master/scripts/install-rknpu.sh | sudo bash

See docs/mirror-policy.md for the mirror governance policy, what is mirrored, when it updates, how to verify integrity independently, and how to self-host the mirror for air-gapped deployments. The same policy will extend to RK3576, Raspberry Pi 4, Mac mini / Apple Silicon, and x86 classes as those verified install paths land.

Quick Start

Controller (server):

```bash

Skills & Plugins Registry

Framework-agnostic skill system with 8 default skills, memory_search, file_read, file_write, web_search, code_exec, image_generation, list_image_models, http_request, categorised by search, files, code, media, browser, data, comms, system. Each skill declares compatibility per framework (native/adapter/unsupported) and works across all 16 supported frameworks via adapter translation. Assign or remove skills per agent from the Skills tab with compatibility badges.

App Store (108 Catalog Apps + 47 MCP Plugins, including 13 Streaming Apps)

One-click install for agent frameworks, AI models, and services. Hardware-aware, only shows what works on your device.

MCP Plugin Catalog (47 Plugins)

app-catalog/plugins/ ships 47 MCP servers including the official set (filesystem, git, fetch, memory, sequential-thinking, time), GitHub, Playwright, Docker, Kubernetes, databases (Postgres/MySQL/SQLite dbhub, MongoDB, Redis, Chroma, Supabase), documents (pandoc, office docs, spreadsheet, markdownify, excel), comms (Slack, WhatsApp, email, Notion, Obsidian, Atlassian, Google Workspace), infra (AWS, Cloudflare, Grafana, arXiv, YouTube transcript, Firecrawl), agent-specific (browser-use, Camoufox, context7, supergateway, engram, Exa), Home Assistant, Todoist, and more.

App Catalog (108 Catalog Apps + 36 Desktop Apps + 47 MCP Plugins)