siddsachar/row-bot

Latest recorded source activity: November 3, 2026 at 13:08

SkillsMP catalog refreshed: November 5, 2026 at 19:57

skills collected: 49

GitHub stars: 1,684
GitHub forks: 203

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/siddsachar/row-bot.

Repository README

Repository README source: README.md

Read the source README

Expand full README

<img src="docs/row_bot_glyph_256.png" alt="Row-Bot" width="180"> <h1 align="center">Row-Bot</h1> (formerly Thoth) <a href="https://github.com/siddsachar/row-bot/releases"><img src="https://img.shields.io/github/v/release/siddsachar/row-bot?style=flat&label=release&color=4F78A4" alt="Release"></a> <a href="https://github.com/siddsachar/row-bot/actions/workflows/ci.yml"><img src="https://github.com/siddsachar/row-bot/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/siddsachar/row-bot?style=flat" alt="License"></a> <img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-4F78A4?style=flat" alt="Platform"> Row-Bot is a local-first desktop AI assistant for doing real work with models, memory and tools. You talk to it in conversations; it remembers what matters in a local knowledge graph, works in the files, code folders, designs, workflows and channels you give it, delegates to focused agents, and asks before anything risky. It runs local models through [Ollama](https://ollama.com/), provider API keys, ChatGPT, Claude or Grok subscriptions, or any OpenAI-compatible endpoint, and keeps your data on your machine. One React app serves the desktop window, browsers, phones and server mode. <img src="docs-site/static/img/screenshots/real-ui/app-shell-overview.png" alt="Row-Bot on Home › Overview" width="900"> ## Features - **Conversations that do the work** - ask for a deck, an app or a report and Row-Bot creates the design or code folder and keeps working in it; setup cards turn on a missing tool or connect an app in place. - **Goals and agents** - goals that keep going until done and pause when they stop making progress; delegated agents with their own conversations, Stop and Message; reusable agent profiles. - **Approvals wherever you are** - risky actions wait for Approve or Deny in the conversation, on Home, in the attention indicator, in Buddy or on a connected channel. - **Memory and knowledge** - a personal knowledge graph with recall, review, Dream Cycle refinement, documents, and an Obsidian-compatible wiki vault. - **Design and code panels** - decks, documents and mockups with Present, Review, export (PDF, HTML, PNG, PPTX) and publish; code folders with changes, files, Git, pull requests, checks, an interactive terminal and an optional Docker sandbox. - **Workflows** - scheduled, webhook and chained runs with approvals, delivery to channels and run history. - **Apps and skills** - connect services such as GitHub, Notion, Linear or Stripe from one catalog in about a minute (sign in, paste a key, or run a program on this computer), choose what each may do, and switch apps per chat with + › Apps or an @mention; add skills from featured catalogs and use them with their /name. - **Tools** - web search, files, shell, managed browser, opt-in Computer Use on Windows and macOS, Gmail and Calendar, image and video generation, and custom tools. - **Channels and voice** - Telegram, WhatsApp, Discord, Slack and SMS; dictation, Talk and read-aloud with local Whisper or SenseVoice and Kokoro. - **Monitor with fixes** - health checks that run by themselves, with one fix per problem, and Insights that suggest improvements. - **Devices and remote access** - connect a phone or another computer with a QR code over Tailscale, your Wi-Fi or a public link; a Buddy desktop overlay on Windows and macOS; backup and restore of your profile. ## Platforms | Platform | Package | Notes | |----------|---------|-------| | Windows 10/11, 64-bit | Installer, about 420 MB | Native window, tray, Buddy overlay, Computer Use. | | macOS 14 (Sonoma) or newer, Apple silicon | DMG, about 930 MB | Native window, tray, Buddy overlay, Computer Use. | | Linux x86_64 (glibc) | Tarball and one-line installer, about 790 MB | Opens in your browser; a native window and tray need GTK or Qt and AppIndicator. | | Docker, amd64 and arm64 | `ghcr.io/siddsachar/row-bot` | Authenticated single-owner server. | Ollama is optional, for local models only. System requirements are in the [installation guide](https://row-bot.ai/docs/getting-started/installation). ## Install Download the Windows installer or the macOS DMG from [GitHub Releases](https://github.com/siddsachar/row-bot/releases/latest) and run it. On Windows it installs for your account only, without administrator rights or questions, and opens Row-Bot when it finishes; on macOS, drag Row-Bot to Applications. On Linux: ```bash curl -fsSL https://raw.githubusercontent.com/siddsachar/row-bot/main/installer/install-linux.sh | bash # or a specific published release (replace X.Y.Z): curl -fsSL https://raw.githubusercontent.com/siddsachar/row-bot/main/installer/install-linux.sh | bash -s -- X.Y.Z ``` The installer takes the latest release by default, verifies the tarball's SHA-256, installs under `~/.local/share/row-bot` and creates `~/.local/bin/row-bot`. With Docker, from a checkout of this repository (pin `X.Y.Z` to a release with a published container): ```bash export ROW_BOT_IMAGE=ghcr.io/siddsachar/row-bot:X.Y.Z docker compose -f deploy/docker/compose.yaml up --detach docker compose -f deploy/docker/compose.yaml exec row-bot \ row-bot access invite --layout desktop --origin http://127.0.0.1:8080 ``` Read [Docker and VPS operations](https://row-bot.ai/docs/operations/docker) before exposing it beyond loopback. Want to run Row-Bot without installing anything? [Upvote it on PikaPods](https://feedback.pikapods.com/posts/1267/row-bot-open-source-ai-assistant-thats-always-on-workflows-memory-browser) to help get it listed there. ### Updates Installed Row-Bot keeps itself up to date: about once a day it checks GitHub, downloads only what changed in the background, checks every file, and shows **Restart to update** when the new version is ready (otherwise it installs the next time you quit). If a new version doesn't start, Row-Bot goes back to the previous one by itself, and Settings › Updates can go back on request. Turn background checks or downloads off in Settings › Updates. Docker installs are updated by pulling a newer image. Your data is never touched. See [Updates](https://row-bot.ai/docs/operations/updates). Upgrading from 5.1? It updates to 5.2 once with the full installer. On Windows, 5.2 moves Row-Bot from Program Files to your account and asks once for administrator approval to remove the old copy; on macOS, drag Row-Bot to Applications one last time; Linux needs nothing. Upgrading from 5.0? Your MCP servers, plugins, skills, accounts and channels carry over to Settings › Apps and Skills; the [v5.1.0 release notes](RELEASE_NOTES.md) say what moved. Upgrading from 4.x? Read the [v5.0.0 release notes](RELEASE_NOTES.md) first: the old NiceGUI interface is gone and several places moved. Users still on Thoth or an early Row-Bot build should first run a previous migration-capable Row-Bot release. ### From source You need Python 3.12 or 3.13, [uv](https://docs.astral.sh/uv/), Git, and Node.js 24.15+ with npm 11 to build the client. ```bash git clone https://github.com/siddsachar/row-bot.git cd row-bot python -m pip install "uv>=0.7,<1.0" uv sync --locked --all-extras --group test cd frontend && npm ci --ignore-scripts --no-audit --no-fund && npm run build && cd .. uv run python launcher.py ``` `launcher.py` starts the tray and opens the app at `http://localhost:8080/app-v2/` (the next free port if 8080 is busy); on Linux it opens your browser. Starting it again while it runs shows the running app. Other entry points: ```bash uv run python launcher.py serve --port 8080 # authenticated headless server uv run python app.py # server only, no tray or window ``` Dependency changes go through `pyproject.toml` and `uv.lock`; never edit `requirements.txt` by hand (see [AGENTS.md](AGENTS.md#dependencies)). ## Quick start 1. On first launch Row-Bot asks **How should Row-Bot think?**: on this computer (Ollama), with your subscription (ChatGPT, Claude or Grok), with an API key, or with a custom endpoint. Your pick becomes the default model, a short test runs, and Home opens. 2. Start a conversation and ask for what you need, for example `Create a six-slide pitch deck for my startup`, `Review this repo and suggest the highest-risk issues`, `Remember that my mom's birthday is March 15` or `Remind me to call the dentist tomorrow at 9am`. 3. Press **Ctrl+K** (**⌘K** on macOS) to find conversations, commands and settings by plain words, such as "connect telegram" or "dark mode". 4. **Setup Center** (Continue setup on Overview, or search for it with Ctrl+K) walks through the rest: knowledge, workflows, designs, code, apps, skills, tools and voice. The [first launch guide](https://row-bot.ai/docs/getting-started/first-launch) covers each path. ## Configuration and data - **Data folder:** `~/.row-bot` (`%USERPROFILE%\.row-bot` on Windows), or the folder in `ROW_BOT_DATA_DIR`. It holds conversations, memory, workflows, settings and logs (`row_bot_app.log` and `logs/row_bot.log`). - **Workspace folder:** `~/Documents/Row-Bot` by default, where file tools, exports and backups go; change it in Settings › System. - **Secrets:** provider keys and sign-ins are stored in Windows Credential Manager, the macOS Keychain or Linux Secret Service/KWallet; Docker uses encrypted records with a separate key volume. JSON settings hold metadata only. - **Backups:** Settings › Data › Back up now makes a zip without secrets. - **Reference:** [models and providers](https://row-bot.ai/docs/configuration/models-and-providers), [environment and configuration](https://row-bot.ai/docs/reference/generated/environment-and-config), [data storage](https://row-bot.ai/docs/reference/generated/data-storage) and [command-line options](https://row-bot.ai/docs/reference/generated/cli). ## Remote access and server mode Row-Bot is a **single-owner, multi-device** application: one owner can use the same instance from several trusted browsers, but it is not multi-user hosting. A device joins with a one-time invitation (a QR code or link that expires after 10 minutes) and then holds a revocable session. Connect devices from Settings › Devices & remote access, or from a trusted terminal: | Path | Use it when | Boundary | |------|-------------|----------| | Tailscale Serve | Private access across your devices (recommended). | Row-Bot never installs Tailscale, signs in, enables Funnel or overwrites another app's route. | | Direct LAN | A trusted network. | Plain HTTP is unencrypted; prefer Tailscale or HTTPS outside a trusted LAN. | | SSH tunnel | A remote host with no published port. | Keep Row-Bot on loopback and forward a port. | | Docker | A headless, isolated instance. | Compose publishes to host loopback by default. | | HTTPS reverse proxy or VPS | You manage DNS, TLS and the proxy. | Set `ROW_BOT_PUBLIC_URL`, `ROW_BOT_ALLOWED_HOSTS` and `ROW_BOT_TRUSTED_PROXY_CIDRS` exactly; never buffer `/api/v1/events`. | ```bash row-bot serve --host 127.0.0.1 --port 8080 row-bot access invite --layout desktop --origin http://127.0.0.1:8080 row-bot access list row-bot access doctor ``` If the owner loses every browser session, create a new invitation from a trusted local terminal, SSH session or `docker compose exec`. Back up the complete active `ROW_BOT_DATA_DIR` while Row-Bot is stopped (with Docker, the data and encryption-key volumes together). Details: [Remote access and server mode](https://row-bot.ai/docs/operations/remote-access) and [Docker and VPS operations](https://row-bot.ai/docs/operations/docker). ## Development - `src/row_bot/` holds the application (FastAPI server, agents, tools, providers, memory, workflows, channels); `frontend/` is the React client, served at `/app-v2/`. See [docs/SOURCE_LAYOUT.md](docs/SOURCE_LAYOUT.md) and [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). - [AGENTS.md](AGENTS.md) is the canonical guide for contributors and coding agents: ground rules, where tests go and the test lanes. - `scripts/run_test_matrix.py` is the test source of truth; CI runs its tiers: ```bash uv run python scripts/run_test_matrix.py fast # static checks and contracts uv run python scripts/run_test_matrix.py changed --base origin/main uv run python scripts/run_test_matrix.py pr # what the Linux PR lane runs uv run python scripts/run_test_matrix.py platform # OS-sensitive tests uv run python scripts/run_test_matrix.py browser-smoke npm --prefix frontend run check # client lint, types, tests, build ``` ## Documentation - [User guide](https://row-bot.ai/docs/) - the complete public documentation ([source](docs-site/README.md)) - [Release notes](RELEASE_NOTES.md) - [Privacy and safety](https://row-bot.ai/docs/privacy-safety), [Computer Use](https://row-bot.ai/docs/computer-use) and its [security decision](docs/COMPUTER_USE_SECURITY.md) - [Architecture](docs/ARCHITECTURE.md), [client platform](docs/CLIENT_PLATFORM.md), [plugin system](docs/PLUGIN_SYSTEM_V2.md) and [prompt context and cache](docs/PROMPT_CONTEXT_AND_CACHE.md) - [Release process](docs/RELEASING.md) and [branching](docs/BRANCHING.md) - [Troubleshooting](https://row-bot.ai/docs/troubleshooting) - [row-bot.ai](https://row-bot.ai/) - product tour and demos ## Privacy Row-Bot has no account system and no hosted inference; conversations, memory and settings stay on your machine, and provider calls go only to the provider or endpoint you choose. Its only first-party telemetry is install stats, on by default: once a day, a random ID, the Row-Bot version and the system, nothing else, so its maker can see how many installations are in use. Turn **Share install stats** off in one click in Settings › System › Privacy, or set `ROW_BOT_INSTALL_COUNT=0` on a server or in Docker. The opt-in Computer Use beta relies on Cua Driver, whose upstream telemetry is disclosed and must be accepted first; see [privacy and safety](https://row-bot.ai/docs/privacy-safety). ## Contributing and security Pull requests are welcome; read [CONTRIBUTING.md](CONTRIBUTING.md) and the [code of conduct](CODE_OF_CONDUCT.md). Please report vulnerabilities privately as described in [SECURITY.md](SECURITY.md). ## License Apache 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE). Built with React, FastAPI, LangGraph, LangChain, Ollama, FAISS, Cua Driver, Kokoro TTS, faster-whisper and FunASR/SenseVoice.

Loading the repository README…

Skills in this repository

Computer Occupations, All Other Software Developers Desktop Publishers Office Clerks, General

10 occupation categories · 43% classified

skill

occupation

description

updated

video-editing-guide

unclassified

Guidance for making videos with video and editing them with edit_video.

2026-11-03

browser-guide

unclassified

Guidance for browser automation workflows.

2026-10-30

shell-guide

unclassified

Guidance for shell commands and system info queries.

2026-10-30

updater-guide

unclassified

Is Row-Bot up to date? Checking for and installing Row-Bot updates.

2026-10-28

workflow-guide

unclassified

How workflows run (scheduled chats), how to write and change them, hand work between them, and check what a run did.

2026-10-28

x-guide

unclassified

Essential guidance for using X (Twitter) tools correctly — search syntax, time filtering, and engagement patterns.

2026-10-28

task-automation

unclassified

Design effective automated workflows using scheduled tasks, clear messages, and delivery channels.

2026-10-28

row-bot-status-guide

unclassified

Guidance for querying and managing Row-Bot's own configuration and logs.

2026-10-24

making-pages

unclassified

Templates and rules for interactive pages beside the chat: plans with approvals, checklists, dashboards, comparisons, forms and small tools.

2026-10-23

pages-guide

unclassified

Guidance for making interactive pages beside the chat with page_create, page_update and page_read.

2026-10-23

calendar-guide

unclassified

Guidance for Google Calendar and Outlook calendar events.

2026-10-22

email-guide

unclassified

Guidance for Gmail and Outlook mail tools and email attachments.

2026-10-22

file-delivery-guide

unclassified

Guidance for sending files to the person's devices or a chat app with send_file.

2026-10-15

telegram-guide

unclassified

Guidance for Telegram messaging tools.

2026-10-15

video-guide

unclassified

Guidance for generating videos and animating images.

2026-10-15

vision-guide

unclassified

Guidance for using webcam, screen capture, and image analysis.

2026-10-15

claude-code-delegation

unclassified

Delegate coding, review, and refactor tasks to Claude Code CLI through Row-Bot's approval-gated shell workflow.

2026-10-14

chart-guide

unclassified

Guidance for data visualisation and chart creation.

2026-10-11

notes-style

unclassified

Write notes as short dated bullet points.

2026-10-06

meeting-prep

unclassified

Prepare a short brief before a meeting.

2026-10-06

pdf-toolkit

unclassified

Fill in and summarise PDF forms.

2026-10-06

concise-writing

unclassified

Make supplied prose clearer and shorter while preserving its meaning.

2026-10-02

text-review

unclassified

Review supplied prose using a packaged checklist and optional local text statistics.

2026-10-02

developer-coding

unclassified

Structured workflow for implementing code changes in a conversation's code folder.

2026-10-01

developer-custom-tools

unclassified

Workflow for creating, testing, enabling, promoting, and removing Custom Tools from a code folder.

2026-10-01

developer-pr-prep

unclassified

Prepare branches, diffs, tests, and GitHub PR text from a conversation's code folder.

2026-10-01

developer-review

unclassified

Code-review workflow for repositories in a conversation's code folder.

2026-10-01

developer-guide

unclassified

Guidance for using the Developer tools to inspect, edit, test, and review code folders safely.

2026-10-01

agents-guide

Computer Occupations, All Other

Guidance for delegating focused work to child Agents.

2026-08-17

filesystem-guide

Software Developers

Guidance for workspace file tools vs shell commands.

2026-08-06

goal-guide

Computer Occupations, All Other

Guidance for durable /goal progress tracking.

2026-06-17

self-reflection

Computer Occupations, All Other

Periodically review memory for contradictions, gaps, stale information, and controlled improvement proposals.

2026-06-11

custom-tool-builder-guide

Computer Occupations, All Other

Guidance for creating reusable Custom Tools from repos or folders.

2026-06-09

brain-dump

Computer Occupations, All Other

Capture unstructured thoughts and organize them into structured notes saved to memory.

2026-06-05

daily-briefing

Office Clerks, General

Compile a morning briefing with weather, calendar, and news headlines.

2026-06-05

data-analyst

Data Scientists

Analyses datasets with professional rigour — statistical summaries, clear narratives, and well-chosen visualisations.

2026-06-05

deep-research

Market Research Analysts & Marketing Specialists

Perform multi-source research on a topic and produce a structured report.

2026-06-05

design-creator

Graphic Designers

Structured workflow for creating professional designs — slide decks, documents, landing pages, app mockups, and motion storyboards.

2026-06-05

humanizer

Technical Writers

Write in a natural, human tone — no AI-speak, no filler, no corporate fluff.

2026-06-05

knowledge-base

Desktop Publishers

Manage the user's personal knowledge base — knowledge graph, documents, and wiki vault.

2026-06-05

Showing 40 of 49 collected skills.