[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83566":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":17,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":23,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":10,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},83566,"row-bot","siddsachar\u002Frow-bot","siddsachar","Row-Bot - Personal AI Sovereignty. A local-first AI assistant with integrated tools, a personal knowledge graph, voice, vision, shell, browser automation, scheduled tasks, health tracking, and messaging channels. Run locally via Ollama or add opt-in cloud models. Your data stays on your machine.","https:\u002F\u002Frow-bot.ai",null,"Python",1255,148,9,17,0,25,75,89.52,"Apache License 2.0",false,"main",true,[25,26,27,28,29,30,31,32],"ai-assistant","langchain","langchain-python","local-llm","ollama","privacy","react-agent","sovereign-ai","2026-06-12 04:01:41","\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Frow_bot_glyph_256.png\" alt=\"Row-Bot\" width=\"180\">\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">Row-Bot\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\u003Csub>(formerly Thoth)\u003C\u002Fsub>\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n   \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsiddsachar\u002Frow-bot\u002Freleases\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fsiddsachar\u002Frow-bot?style=flat&label=release&color=4F78A4\" alt=\"Release\">\u003C\u002Fa>\n   \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsiddsachar\u002Frow-bot\u002Factions\u002Fworkflows\u002Fci.yml\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fsiddsachar\u002Frow-bot\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg\" alt=\"CI\">\u003C\u002Fa>\n   \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fsiddsachar\u002Frow-bot?style=flat\" alt=\"License\">\u003C\u002Fa>\n   \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Windows%20%7C%20macOS%20%7C%20Linux-4F78A4?style=flat\" alt=\"Platform\">\n\u003C\u002Fp>\n\nRow-Bot is a local-first desktop AI assistant for reasoning through work, orchestrating tools and models, and getting durable tasks done on your machine. The name is literal: **Reason. Orchestrate. Work.**\n\nIt gives you chat, memory, tools, workflows, Developer Studio, Designer Studio, Smart Skills, Skills Hub, Custom Tools, plugins, messaging channels, realtime voice, and flexible model routing while keeping durable data local.\n\nBring the model path that fits the job: local models through [Ollama](https:\u002F\u002Follama.com\u002F), OpenAI, Anthropic, Google AI, xAI, MiniMax, OpenRouter, Ollama Cloud, ChatGPT \u002F Codex subscription models, or custom OpenAI-compatible endpoints such as oMLX, LM Studio, vLLM, llama.cpp, LocalAI, LiteLLM, and SGLang. Row-Bot keeps provider identity, model capabilities, context limits, and chat-only fallbacks explicit so local, hosted, and self-hosted models can coexist without surprise routing.\n\nThe Row-Bot app has no account system, no Row-Bot-hosted server, and no telemetry pipeline. Provider keys and subscription tokens are stored in the OS credential store when available.\n\nDownload the latest installer from [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fsiddsachar\u002Frow-bot\u002Freleases). Windows and macOS use one-click installers. Linux has a one-line user installer.\n\n\u003Ctable align=\"center\">\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FansfEqAr6g0\">\u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FansfEqAr6g0\u002Fmaxresdefault.jpg\" width=\"360\" alt=\"Demo 1\">\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002F61JFO0ElgBE\">\u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002F61JFO0ElgBE\u002Fmaxresdefault.jpg\" width=\"360\" alt=\"Demo 2\">\u003C\u002Fa>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FdMoSay7uyoc\">\u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FdMoSay7uyoc\u002Fmaxresdefault.jpg\" width=\"360\" alt=\"Demo 3\">\u003C\u002Fa>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FxYJC2IVKH7Y\">\u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FxYJC2IVKH7Y\u002Fmaxresdefault.jpg\" width=\"360\" alt=\"Demo 4\">\u003C\u002Fa>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## What You Get\n\n| Area | Details |\n|------|---------|\n| Agent and models | LangGraph ReAct agent, streaming responses, thinking bubbles, smart context trimming, provider-qualified model selection, readiness routing, chat-only fallback for non-tool models, custom endpoint profiles and probes, live MiniMax discovery, OpenCode providers, local and hosted model catalogs, background model cache, and per-thread, per-workflow, and per-Developer model overrides. |\n| Memory and knowledge | Personal knowledge graph, 10 entity types, 67 typed relations, bounded semantic\u002Flexical\u002Fgraph recall, audit and review states, recall traces, graph visualization, Obsidian-compatible wiki export, document extraction with source provenance, Dream Cycle refinement, duplicate merging, stale-confidence decay, relationship inference, self-knowledge, insights, and conversation search. |\n| Tools | 30+ core tool modules for web search, DuckDuckGo, Wikipedia, arXiv, YouTube transcripts, URL reading, documents, wiki vault, Gmail, Google Calendar, filesystem, shell, browser automation, workflows, tracker, channels, X, image generation\u002Fediting, video generation, MCP, Developer Studio, Designer Studio, Custom Tool Builder, status, calculator, Wolfram Alpha, weather, vision, memory, system info, and charts. File tools read PDF, CSV, Excel, JSON, JSONL, TSV, and image files, with schema, stats, previews, and PDF export where supported. |\n| Developer Studio | Local Git workspace linking and cloning, code threads, repo inspector, file tree, diffs, todos, tests, branch, commit, push and PR prep, approval modes, and optional Docker Sandbox with a shadow workspace and explicit import back into the real repo. |\n| Designer Studio | Decks, documents, landing pages, app mockups, and storyboards with a sandboxed interactive runtime, templates, brand controls, critique and repair, AI image and video generation, chart insertion, Mermaid and Plotly rendering, shareable HTML, and export to PDF, HTML, PNG, and PPTX. |\n| Workflows | Scheduled runs, webhook triggers, task-completion triggers, step pipelines, conditions, approvals, subtasks, notification-only runs, concurrency groups, delivery defaults, per-workflow model\u002Ftool\u002Fskill overrides, safety modes, run status, run history, upcoming runs, and a Workflow Console. |\n| Channels and voice | Telegram, WhatsApp, Discord, Slack, and SMS with streaming, reactions, media intake, voice transcription, document extraction, approval routing, health checks, auto-generated send\u002Fphoto\u002Fdocument tools, and optional tunnel support. Realtime voice adds provider-backed voice sessions, action handling, speech\u002Fcue policy, and local faster-whisper STT plus Kokoro TTS options. |\n| Platform and app | Native desktop app, setup wizard, tray integration on Windows and macOS, desktop notifications, local browser-first Linux launch, optional Linux native window\u002Ftray mode, faster transcript and Settings surfaces, Home status bar for models, OAuth, MCP, plugins, documents, workflows, Buddy, logging, disk, task DB recovery, and verified auto-updates. |\n| Extensibility | Smart Skills, slash commands, Skills Hub browsing\u002Fimport\u002Fsearch, sandboxed plugin marketplace, bundled skills and tool guides, external MCP clients over stdio, Streamable HTTP, and SSE, Custom Tools from repos or folders, Claude Code Delegation through an approval-gated CLI worker, migration from selected Hermes\u002FOpenClaw data, setup center, identity settings, and stability diagnostics. |\n\nSee [docs\u002FARCHITECTURE.md](docs\u002FARCHITECTURE.md) for the full subsystem reference.\n\n## Install\n\n### Windows\n\n1. Download the latest [Windows installer](https:\u002F\u002Fgithub.com\u002Fsiddsachar\u002Frow-bot\u002Freleases\u002Flatest).\n2. Run it. The installer bundles the embedded Python runtime, app source, and Python dependencies. Ollama is optional and only needed for local models.\n3. Launch Row-Bot from the Start Menu or desktop shortcut.\n\nUser data lives in `%USERPROFILE%\\.row-bot`. Repairing or upgrading replaces the bundled runtime and preserves your data. Startup logs are written to `%USERPROFILE%\\.row-bot\\row_bot_app.log`, including recovery hints for known optional audio package issues such as TorchCodec.\n\n### macOS\n\n1. Download the latest [macOS DMG](https:\u002F\u002Fgithub.com\u002Fsiddsachar\u002Frow-bot\u002Freleases\u002Flatest).\n2. Drag `Row-Bot.app` into Applications.\n3. Launch Row-Bot from Applications or Launchpad.\n\nThe first run may ask you to confirm that the app was downloaded from the internet. The packaged app uses its bundled Python runtime and dependencies, and it starts Ollama if Ollama is already installed. Apple Silicon and Intel Macs are supported on macOS 12+.\n\nIf you only want provider models or a custom endpoint, you can skip model downloads during setup.\n\n### Linux\n\nRun:\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsiddsachar\u002Frow-bot\u002Fmain\u002Finstaller\u002Finstall-linux.sh | bash\n```\n\nTo install a specific version:\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsiddsachar\u002Frow-bot\u002Fmain\u002Finstaller\u002Finstall-linux.sh | bash -s -- 4.0.1\n```\n\nThe installer downloads the release tarball, verifies its SHA256 from the GitHub release manifest, installs under `~\u002F.local\u002Fshare\u002Frow-bot`, creates `~\u002F.local\u002Fbin\u002Frow-bot`, and stores user data in `~\u002F.row-bot`. The default Linux build opens in your system browser. Native window and tray support are available when the required GTK, Qt, and AppIndicator libraries are installed.\n\nManual tarball install:\n\n```bash\ntar -xzf Row-Bot-X.Y.Z-Linux-x86_64.tar.gz\ncd Row-Bot-X.Y.Z-Linux-x86_64\n.\u002Finstall.sh\nrow-bot\n```\n\nIf `~\u002F.local\u002Fbin` is not on `PATH`, run `~\u002F.local\u002Fbin\u002Frow-bot` or add it to your shell profile. On Linux, provider secrets use Secret Service or KWallet when available. WSL and headless systems can run without a keyring, but new secrets are session-only until secure storage is configured.\n\nFor browser automation, Chromium may need distro packages that the tarball cannot install. If Playwright reports missing dependencies, run the command it prints, or use `python -m playwright install --with-deps chromium` from a source checkout.\n\n### Upgrading from Thoth 3.x\n\nRow-Bot v4 is the renamed successor to Thoth. On first launch, Row-Bot copies supported Thoth 3.x data into the new Row-Bot data locations and leaves the original Thoth data in place. Provider settings, channels, skills, MCP servers, plugins, Buddy assets, Designer workspaces, conversations, memories, tasks, media, and updater state are included in the migration path.\n\nThe major-version rebrand also changes app names, installer names, release artifact names, Linux commands, and data directories. Existing Thoth users should install Row-Bot v4 with the new installer rather than expecting the 3.x updater contract to replace itself in place.\n\n## Quick Start\n\nOn first launch, Row-Bot opens a setup wizard. Pick one of three paths:\n\n| Mode | Use it when | Setup |\n|------|-------------|-------|\n| Local | You want inference and embeddings on your machine. | Choose a local runtime, download a recommended model such as `qwen3:14b` or a smaller model such as `qwen3:8b`, then start chatting. Ollama is the supported local runtime today. |\n| Providers | You want hosted models, frontier reasoning, or no local model download. | Add an OpenAI, Anthropic, Google AI, xAI, MiniMax, OpenRouter, or Ollama Cloud key, pick a default model, and save Quick Choices. ChatGPT \u002F Codex sign-in is available in Settings after launch. |\n| Custom\u002FSelf-hosted | You run oMLX, LM Studio, vLLM, llama.cpp, LocalAI, LiteLLM, SGLang, or a private gateway. | Enter an OpenAI-compatible base URL such as `http:\u002F\u002F127.0.0.1:1234\u002Fv1`, choose the closest compatibility profile, add a key if your server requires one, fetch models, and choose a default. |\n\nCommon first prompts:\n\n- `Remember that my mom's birthday is March 15`\n- `Search for recent papers on transformer architectures`\n- `Read report.pdf in my workspace`\n- `Run git status on my project`\n- `Create a six-slide pitch deck for my startup`\n- `Show my headache trends this month`\n- `Remind me to call the dentist tomorrow at 9am`\n- `Review this repo and suggest the highest-risk issues`\n- `Turn this GitHub repo into a Custom Tool`\n- `What did I ask about taxes last week?`\n\nFor local and self-hosted servers, use a context window large enough for Row-Bot's agent prompt and tool schemas. A `4096` context can fail before the first chat turn with misleading prompt-template errors. `32768` is a practical starting point for agent mode. Models that are useful for normal conversation but not reliable with tools can still run through chat-only mode.\n\n## Models, Keys, and Integrations\n\nMost tools work without API keys. Add keys only for the providers and integrations you use.\n\nModel catalog browsing, pinning, defaults, and Quick Choices live in Settings → Models. Model choices stay provider-qualified, so the same model ID from a local runtime, OpenRouter, a custom endpoint, or a direct provider remains distinct. Row-Bot also tracks whether a selected model is ready for full agent\u002Ftool use, should run chat-only, or needs a larger context window or different endpoint profile.\n\n| Service | Key or setup | Used for |\n|---------|--------------|----------|\n| OpenAI | `OPENAI_API_KEY` | OpenAI models and image tools. |\n| ChatGPT \u002F Codex | In-app ChatGPT sign-in | Subscription-backed Codex models through ChatGPT's internal backend. |\n| Anthropic | `ANTHROPIC_API_KEY` | Claude models through the direct API. |\n| Google AI | `GOOGLE_API_KEY` | Gemini models, Imagen, and Veo. |\n| xAI | `XAI_API_KEY` | Grok models, Grok Imagine, and Grok Imagine Video. |\n| MiniMax | `MINIMAX_API_KEY` | Current MiniMax models through the Anthropic-compatible API, discovered from the live provider catalog where available. |\n| OpenRouter | `OPENROUTER_API_KEY` | Access to 100+ provider models. |\n| Ollama Cloud | `OLLAMA_CLOUD_API_KEY` or local daemon sign-in | Direct Ollama Cloud models and cloud-tagged daemon models. |\n| Custom OpenAI-compatible endpoint | Base URL and optional key | Self-hosted or proxy models through profiles for oMLX, LM Studio, vLLM, llama.cpp, LocalAI, LiteLLM, SGLang, and generic servers. |\n| Tavily | `TAVILY_API_KEY` | Live web search. |\n| Wolfram Alpha | `WOLFRAM_ALPHA_APPID` | Symbolic math, unit conversion, and scientific data. |\n| Telegram | `TELEGRAM_BOT_TOKEN` | Telegram bot messaging. |\n| Discord | `DISCORD_BOT_TOKEN` | Discord DM messaging. |\n| Slack | `SLACK_BOT_TOKEN` \u002F `SLACK_APP_TOKEN` | Slack DM messaging through Socket Mode. |\n| Twilio | `TWILIO_ACCOUNT_SID` \u002F `TWILIO_AUTH_TOKEN` | SMS. |\n| X | `X_CLIENT_ID` \u002F `X_CLIENT_SECRET` | X API v2 OAuth 2.0 PKCE for search, timeline, mentions, posting, replies, quotes, likes, reposts, bookmarks, and deletes. |\n| ngrok | `NGROK_AUTHTOKEN` | Tunnels for inbound webhooks. |\n| Gmail and Google Calendar | Google Cloud OAuth `credentials.json` | Email search\u002Fread\u002Fdraft\u002Fsend and calendar view\u002Fcreate\u002Fupdate\u002Fmove\u002Fdelete. |\n\nConfigure providers in Settings, Channels, and Accounts. Keys and in-app ChatGPT \u002F Codex tokens are stored in Windows Credential Manager, macOS Keychain, or Linux Secret Service\u002FKWallet when available. `~\u002F.row-bot\u002Fapi_keys.json` and `~\u002F.row-bot\u002Fproviders.json` keep metadata only, such as saved state, provider status, Quick Choices, compatibility profiles, probe results, and masked fingerprints.\n\nEmbedding providers are configured separately from chat models. Local embeddings are available for private document and vector indexing. Optional cloud embeddings show a privacy warning because document text is sent to the selected embedding provider.\n\nExternal Codex CLI login files are metadata\u002Freference only. Row-Bot can detect that a CLI login exists, but direct Codex runtime requires the in-app ChatGPT sign-in and does not copy runnable tokens from `~\u002F.codex\u002Fauth.json`.\n\n## Tools and Safety\n\nRow-Bot's tools can be enabled or disabled from Settings. Many tools expose multiple operations, Developer Studio adds code-specific tools, Skills Hub can add manual skills, Custom Tools can be promoted after review, and running channels add send\u002Fphoto\u002Fdocument tools automatically.\n\n| Group | Included tools |\n|-------|----------------|\n| Search and knowledge | Tavily web search, DuckDuckGo, Wikipedia, arXiv, YouTube transcripts, URL reader, document search, wiki vault, memory graph, and conversation search. |\n| Productivity | Gmail, Google Calendar, filesystem, shell, visible Chromium browser automation, workflows, tracker, channel tools, and X. |\n| Media and design | Designer Studio, image generation\u002Fediting through OpenAI, Google, and xAI, video generation through Google Veo and xAI Grok Imagine Video, chart insertion, Mermaid, Plotly, and media persistence. |\n| Developer and extensibility | Developer Studio, Custom Tool Builder, promoted Custom Tools, external MCP tools, plugin tools, Claude Code Delegation, and Row-Bot Status. |\n| Analysis | Calculator, Wolfram Alpha, weather, vision for camera\u002Fscreen\u002Fworkspace images, system info, and Plotly charts with PNG export. |\n\nSafety controls are built into the tool layer:\n\n- Destructive operations require confirmation, including file delete\u002Fmove, moderate-risk shell commands, Gmail send, calendar move\u002Fdelete, memory delete, tracker delete, and task delete.\n- Filesystem access is sandboxed to the configured workspace folder, which defaults to `~\u002FDocuments\u002FRow-Bot`.\n- Shell commands are classified as safe, moderate, or blocked. High-risk commands such as `shutdown`, `reboot`, and `mkfs` are blocked.\n- Background workflows can have per-task command prefix and email-recipient allowlists.\n- Browser tabs are isolated per thread and cleaned up when tasks or threads finish.\n- Developer Studio has its own approval modes for edits, commands, Git operations, commits, pushes, and PR prep.\n- Docker Sandbox is opt-in and runs commands in a shadow workspace until you explicitly import changes.\n- Smart Skills, slash commands, and Skills Hub imports stay user-controlled; installed skills can be enabled, disabled, reviewed, and removed.\n- Custom Tools are reviewed, smoke-tested, enabled, promoted, disabled, and removed without deleting their source repos.\n- Gmail and Calendar permissions are tiered for read, compose\u002Fwrite, and destructive actions.\n- MCP servers stay disabled until tested. External tools are namespaced, destructive MCP tools require approval, and broken servers degrade to diagnostics instead of blocking startup.\n- Prompt-injection defense scans tool outputs and user inputs for instruction override attempts, role impersonation, data exfiltration, encoding evasion, and social engineering patterns.\n\n## Architecture\n\nRow-Bot is organized around reasoning, orchestration, and work: context assembly, memory, workflows, channels, Designer Studio, Developer Studio, plugin\u002FMCP boundaries, and safety controls.\n\nExplore the visual architecture gallery: [docs\u002Farchitecture.html](docs\u002Farchitecture.html)\n\nRead the full architecture reference: [docs\u002FARCHITECTURE.md](docs\u002FARCHITECTURE.md#core-modules)\n\n\u003Ctable>\n   \u003Ctr>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FCore_Agent_Arch.png\">\u003Cimg src=\"docs\u002FCore_Agent_Arch.png\" width=\"360\" alt=\"Row-Bot core agent architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Core Agent\u003C\u002Fstrong>\u003C\u002Ftd>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FContext_Arch.png\">\u003Cimg src=\"docs\u002FContext_Arch.png\" width=\"360\" alt=\"Row-Bot context architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Context Assembly\u003C\u002Fstrong>\u003C\u002Ftd>\n   \u003C\u002Ftr>\n   \u003Ctr>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FKnowledge_Graph_Arch.png\">\u003Cimg src=\"docs\u002FKnowledge_Graph_Arch.png\" width=\"360\" alt=\"Row-Bot knowledge graph architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Knowledge Graph\u003C\u002Fstrong>\u003C\u002Ftd>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FWorkflows_Arch.png\">\u003Cimg src=\"docs\u002FWorkflows_Arch.png\" width=\"360\" alt=\"Row-Bot background workflow architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Background Workflows\u003C\u002Fstrong>\u003C\u002Ftd>\n   \u003C\u002Ftr>\n   \u003Ctr>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FMulti_Channel_Arch.png\">\u003Cimg src=\"docs\u002FMulti_Channel_Arch.png\" width=\"360\" alt=\"Row-Bot multi-channel architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Multi-Channel Runtime\u003C\u002Fstrong>\u003C\u002Ftd>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FDesigner_Studio_Arch.png\">\u003Cimg src=\"docs\u002FDesigner_Studio_Arch.png\" width=\"360\" alt=\"Row-Bot Designer Studio architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Designer Studio\u003C\u002Fstrong>\u003C\u002Ftd>\n   \u003C\u002Ftr>\n   \u003Ctr>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FDeveloper_Studio_Arch.png\">\u003Cimg src=\"docs\u002FDeveloper_Studio_Arch.png\" width=\"360\" alt=\"Row-Bot Developer Studio architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Developer Studio\u003C\u002Fstrong>\u003C\u002Ftd>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FSkills_System_Arch.png\">\u003Cimg src=\"docs\u002FSkills_System_Arch.png\" width=\"360\" alt=\"Row-Bot skills system architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Skills System\u003C\u002Fstrong>\u003C\u002Ftd>\n   \u003C\u002Ftr>\n   \u003Ctr>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FSafety_Privacy_Arch.png\">\u003Cimg src=\"docs\u002FSafety_Privacy_Arch.png\" width=\"360\" alt=\"Row-Bot safety privacy and control architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Safety, Privacy & Control\u003C\u002Fstrong>\u003C\u002Ftd>\n      \u003Ctd align=\"center\">\u003Ca href=\"docs\u002FSelf_Evolution_Arch.png\">\u003Cimg src=\"docs\u002FSelf_Evolution_Arch.png\" width=\"360\" alt=\"Row-Bot self-evolution architecture\">\u003C\u002Fa>\u003Cbr>\u003Cstrong>Self-Evolution\u003C\u002Fstrong>\u003C\u002Ftd>\n   \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## System Requirements\n\n| Setup | Minimum | Recommended |\n|-------|---------|-------------|\n| Local model runtime | Windows 10\u002F11 64-bit, macOS 12+, or glibc Linux x86_64; Python 3.11+; 8 GB RAM for 8B models; about 5 GB disk for the app and one small model; internet for install and model download. | 16 to 32 GB RAM for 14B to 30B models; NVIDIA GPU with 8+ GB VRAM or Apple Silicon for much faster inference; 20+ GB disk for multiple or larger models. |\n| Provider\u002Fcustom models only | Windows 10\u002F11 64-bit, macOS 12+, or glibc Linux x86_64; Python 3.11+; 4 GB RAM; about 1 GB disk; internet for provider inference. | No GPU required. Use this path if you do not want local model downloads. |\n| Developer Sandbox | Docker Desktop or a compatible Docker\u002FPodman runtime. | Optional. Developer Studio also works with local execution in the selected repo. |\n\nYour default Brain model is set by the setup wizard. If you choose the local path, Row-Bot uses one of the models already exposed by your local runtime; 14B-class models are recommended for stronger agent\u002Ftool behavior, while smaller 8B-class models are better for 8 GB machines. Hosted and custom endpoint setups can skip local model downloads entirely.\n\n## From Source\n\nInstall [Ollama](https:\u002F\u002Follama.com\u002F) first if you want Row-Bot's supported local model runtime. Provider-only and custom-endpoint setups can skip local model downloads.\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fsiddsachar\u002Frow-bot.git\ncd row-bot\npython -m venv .venv\n```\n\nActivate the environment:\n\n```bash\n# Windows\n.venv\\Scripts\\activate\n\n# macOS \u002F Linux\nsource .venv\u002Fbin\u002Factivate\n```\n\nInstall dependencies and launch:\n\n```bash\npip install -r requirements.txt\npython launcher.py\n```\n\nOn Windows and macOS, `launcher.py` starts the tray icon and opens the app on the first available local port, normally `http:\u002F\u002Flocalhost:8080`. On Linux it opens in the browser without a tray by default. If port 8080 is busy, Row-Bot picks the next free port.\n\nHeadless Linux\u002Fserver mode:\n\n```bash\npython launcher.py --server --no-open --port 8080\n```\n\nDirect app launch:\n\n```bash\npython app.py\n```\n\nDirect launches default to `http:\u002F\u002Flocalhost:8080`. Set `ROW_BOT_PORT` to choose a different port.\n\nRecovery helpers:\n\n```bash\npython launcher.py --reset-tasks-db\npython launcher.py --reset-db\npython launcher.py --restore-data\n```\n\nThese commands back up local SQLite files before recreating or restoring known task, memory, and thread databases.\n\n## Privacy\n\nLocal model runs stay on your machine. Documents, memories, conversations, knowledge graph data, workflows, logs, and user settings are stored locally under `~\u002F.row-bot` or the platform-specific Row-Bot app data paths used by the installer. Migrated Thoth 3.x data is copied into Row-Bot locations; the original Thoth data is left in place.\n\nProvider and custom models are opt-in. When selected, the current conversation, model-visible tool context, and tool results are sent to that endpoint. Memories, documents, files, graph data, and other conversations stay local unless you explicitly include them in the current conversation or expose them through a tool result. Memory recall happens locally before any selected memory is inserted into the active turn.\n\nDeveloper Studio only touches repos you link or clone. Local execution runs in that repo. Docker Sandbox runs in a shadow copy and requires explicit import before changing the real repo. Skills Hub imports and Custom Tools are opt-in, testable or reviewable, removable, and only affect normal chat after you enable or promote them.\n\nRow-Bot does not require a Row-Bot account, and there is no Row-Bot-hosted middleman for provider calls.\n\n## Project Docs\n\n- [Architecture](docs\u002FARCHITECTURE.md)\n- [Visual architecture gallery](docs\u002Farchitecture.html)\n- [Contributing guide](CONTRIBUTING.md)\n- [Branching strategy](docs\u002FBRANCHING.md)\n- [Release process](docs\u002FRELEASING.md)\n- [Source layout and packaging](docs\u002FSOURCE_LAYOUT.md)\n- [Security policy](SECURITY.md)\n- [Code of conduct](CODE_OF_CONDUCT.md)\n\nAll changes should go through a pull request. `main` is intended to stay releasable.\n\n## License\n\nApache 2.0. See [LICENSE](LICENSE).\n\n## Acknowledgements\n\nBuilt with [NiceGUI](https:\u002F\u002Fnicegui.io\u002F), [LangGraph](https:\u002F\u002Flangchain-ai.github.io\u002Flanggraph\u002F), [LangChain](https:\u002F\u002Fpython.langchain.com\u002F), [Ollama](https:\u002F\u002Follama.com\u002F), [FAISS](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Ffaiss), [Kokoro TTS](https:\u002F\u002Fgithub.com\u002Fthewh1teagle\u002Fkokoro-onnx), [faster-whisper](https:\u002F\u002Fgithub.com\u002FSYSTRAN\u002Ffaster-whisper), [HuggingFace](https:\u002F\u002Fhuggingface.co\u002F), and [tiktoken](https:\u002F\u002Fgithub.com\u002Fopenai\u002Ftiktoken).\n",2,"2026-06-11 04:11:22","high_star"]